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Memory Insufficient 
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Serial Bus Data Frame Overrun 
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Serial bus data frame checksum error 


! 




4 


Too Many Variables 
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LOAD File Error 
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PREFACE 



This manual assumes the user has read the Atari BASIC — A Self-Teaching 
Guide or some other book on BASIC. This manual is not intended to "teach" 
BASIC. It is a reference guide to the commands, statements, functions, and 
special applications of Atari® BASIC. 

The programs and partial programming examples used in this manual are 
photostats of listings printed on the Atari 820™ Printer. Some of the special sym- 
bols in the Atari character set do not appear the same on the printer; e.g., the 
clear screen symbol "■*(" appears as a " }". The examples in the text were 
chosen to illustrate a particular function — not necessarily "good" programming 
techniques. 

Each of the sections contains groups of commands, functions, or statements 
dealing with a particular aspect of Atari BASIC. For instance, Section 9 contains 
all the statements pertaining to Atari's unique graphics capabilities. The appen- 
dices include quick references to terms, error messages, BASIC keywords, 
memory locations, and the ATASCII character set. 

As there is no one specified application for the Atari Personal Computer System, 
this manual is directed at general applications and the general user. Appendix H 
contains programs that illustrate a few of the Atari system's capabilities. 
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GENERAL 
INFORMATION 



This section explains BASIC terminology, special notations, and abbreviations 
used in this manual, and the special keys on the ATARI 400™ and ATARI 800™ 
Personal Computer Systems keyboard. It also points to other sections where 
BASIC commands deal with specific applications. 

TERMINOLOGY BASIC: Beginner's All-purpose Symbolic Instruction Code. 

BASIC Keyword: Any reserved word "legal" in the BASIC language. May be 
used in a statement, as a command, or for any other purpose. (See Appendix A 
for a list of all "reserved words" or keywords in ATARI BASIC.) 

BASIC Statement: Usually begins with a keyword, like LET, PRINT, or 
RUN. 

Constant: A constant is a value expressed as a number rather than represented 
by a variable name. For example, in the statement X = 100, X is a variable and 
f~\ 100 is a constant. (See Variable.) 

Command String: Multiple commands (or program statements) placed on the 
same numbered line separated by colons. 

Expression: An expression is any legal combination of variables, constants, 
operators, and functions used together to compute a value. Expressions can be 
either arithmetic, logical, or string. 

Function: A function is a computation built into the computer so that it can be 
called for by the user's program. A function is NOT a statement; it is part of an 
expression. It is really a subroutine used to compute a value which is then 
"returned" to the main program when the subroutine returns. COS (Cosine), 
RND (random), FRE (unused memory space), and INT (integer) are examples of 
functions. In many cases the value is simply assigned to a variable (stored in a 
variable) for later use. In other cases it may be printed out on the screen im- 
mediately. See Section 6 for more on functions. Examples of functions as they 
might appear in programs are: 

10 PRINT RNDC0) (print out the random 

number returned) 

10 V= 1 0fi+r:n: r ;c 45) (add the value re- 

returned to 100 and 
store the total in 
variable X) 
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Logical Line: A logical line consists of one to three physical lines, and is ter- 
minated either by aJSHSJI or automatically when the maximum logical line 
limit is reached. Each numbered line in a BASIC program consists of one logical 
line when displayed on the screen. When entering a line which is longer than 
one physical line, the cursor will automatically go to the beginning of the next 
physical line when the end of the current physical line is reached. If ffHWECT is 
not entered, then both physical lines will be part of the same logical line. 

Operator: Operators are used in expressions. Operators include addition (+), 
subtraction (-), multiplication ( * ), division (/), exponentiation (A), greater than 
(», less than (<), equal to (=), greater than or equal to (> = ), less than or equal to 
(<=), and not equal to (<>). The logical keywords AND, NOT and OR are also 
operators. The + and - operators can also be used as unary operators; e.g., - 3. 
Do not put several unary operators in a row; e.g., 3, as the computer will in- 
terpret it incorrectly. 

Physical Line: One line of characters as displayed on a television screen. 

String: A string is a group of characters enclosed in quotation marks. 
"ABRACADABRA" is a string. So are "ATARI MAKES GREAT COMPUTERS" 
and "123456789". A string is much like a constant, as it too, may be stored in a 
variable. A string variable is different, in that its name must end in the 
character $. For example, the string "ATARI 800" may be assigned to a variable 
called A$ using (optional) LET like this: 

18 LET A$=" ATARI 399" (note quotation marks) 

OR 
10 H$=" ATARI 888 ,! (LET is optional; the 

quotes are required.) 

Quotation marks may not be used within a string. However, the closing quota- 
tion can be omitted if it is the last character on a logical line. (See Section 7 - 
STRINGS). 

Variable: A variable is the name for a numerical or other quantity which may 
(or may not) change. Variable names may be up to 120 characters long. 
However, a variable name must start with an alphabetic letter, and may contain 
only capital letters and numerical digits. It is advisable not to use a keyword as a 
variable name or as the first part of a variable name as it may not be interpreted 
correctly. Examples of storing a value in a variable: 

LETC1230UB= 1.234 
LETUARIABLE1 12=267. 543 
LETA=1 
LETF5TH=6.5 
LETTHISHO = 59.889 

Note: LET is optional and may be omitted) 



Variable Name Limit: ATARI BASIC limits the user to 128 variable names.To 
bypass this problem, use individual elements of an array instead of having 
separate variable names. BASIC keeps all references to a variable which has 
been deleted from a program, and the name still remains in the variable name 
table. f 
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If the screen displays an ERROR-4 (Too Many Variables) message, use the follow- 
ing procedure to make room for new variable names: 

LIST filespec 

NEW 

ENTER filespec 

The LIST filespec writes the untokenized version of the program onto a disk or 
cassette. NEW clears the program and the table areas. The program is then re- 
entered, re-tokenized, and a new variable table is built. (The tokenized version 
is Atari BASIC'S internal format. The untokenized versions in ATASCII 
which is the version displayed on the screen). 

Arrays and Array Variables: An array is a list of places where data can be 
filed for future use. Each of these places is called an element, and the whole array 
or any element is an array variable. For example, define "Array A" as having 6 
elements. These elements are referred to by the use of subscripted variables 
such as A(2), A(3), A(4), etc. A number can be stored in each element. This 
may be accomplished element by element (using the LET statement), or as a part 
of a FOR/NEXT loop (see Chapter 8). 

Note: Never leave blanks between the element number in parentheses and the 
name of the array. 



Correct 

A(23) 

ARRAY(3) 

X123C38) 



Incorrect 

A (23) 

ARRAY (3) 

X123 (38) 



SPECIAL 
NOTATIONS 
USED IN THIS 
MANUAL 



Line Format: The format of a line in a BASIC program includes a line number 
(abbreviated to lineno) at the beginning of the line, followed by a statement 
keyword, followed by the body of the statement and ending with a line ter- 
minator command ( l:UJII:IJI kpv). In an actual program, the four elements might 
look like this: 



Line Number 
100 



STATEMENT 



Keyword 
PRINT 



A/X 



Body 

* (Z + 4.567) 



Terminator 

i,i=u'i,i:i 



Several statements can be typed on the same line provided they are separated by 
colons (:). See IF/THEN in Section 5, and Section 11. 

Capital Letters: In this book, denote keywords to be typed by the user in up- 
per case form exactly as they are printed in this text. Reverse-video characters 
will not work except in the case of the RUN command. Here are a few ex- 
amples: 



PRINT 



INPUT LIST 



END 



GOTO GOSUB 



FOR 



NEXT 



IF 
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Lower Case Letters: In this manual, lower case letters are used to denote the 
various classes of items which may be used in a program, such as variables 
(var), expressions (exp), and the like. The abbreviations used for these classes of 
items are shown in Table 1.1. 
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Items in Brackets: Brackets, [ ], contain optional items which may be used, 
but are not required. If the item enclosed in brackets is followed by three dots 
[exp,...], it means that any number of expressions may be entered, but none are 
required. 

Items stacked vertically in braces: Items stacked vertically in braces indicate 
that any one of the stacked items may be used, but that only one at a time is per- 
missible. In the example below, type either the GOTO or the GOSUB. 



100 



f GOTO ) 
} GOSUB ) 



2000 



Command abbreviations in headings: If a command or statement has an ab- 
breviation associated with it, the abbreviation is placed following the full name 
of the command in the heading; e.g., LET (L.). 

ABBREVIATIONS The following table explains the abbreviations used throughout this manual: 

USED IN THIS 

MANUAL TABLE 1.1 ABBREVIATIONS 

avar Arithmetic Variable: A location where a numeric value is 

stored. Variable names may be from 1 to 120 alphanumeric 
characters, but must start with an alphabetic character, and all 
alpha characters must be unreversed and upper case. 

svar String Variable: A location where a string of characters may be 

stored. The same name rules as avar apply, except that the last 
character in the variable name must be a $. String variables may 
be subscripted. See Section 7, STRINGS. 

mvar Matrix Variable: Also called a Subscripted Variable. An ele- 

ment of an array or matrix. The variable name for the array or 
matrix as a whole may be any legal variable name such as A, X, 
Y, ZIP, or K. The subscripted variable (name for the particular 
element) starts with the matrix variable, and then uses a number, 
variable, or expression in parentheses immediately following the 
array or matrix variable. For example, A(ROW), A(l), A(X + 1). 

var Variable: Any variable. May be mvar, avar, or svar. 

aop Arithmetic operator. 

lop Logical operator. 

aexp Arithmetic Expression: Generally composed of a variable, 

function, constant, or two arithmetic expressions separated by an 
arithmetic operator. 

lexp Logical Expression: Generally composed of two arithmetic or 

string expressions separated by a logical operator. Such an ex- 
pression evaluates to either a 1 (logical true) or a (logical false). 

For example, the expression 1<2 evaluates to the value 1 (true) 
while the expression "LEMON" = "ORANGE" evaluates to a zero 
(false) as the two strings are not equal. 
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sexp String Expression: Can consist of a string variable, string literal 

(constant), or a function that returns a string value. 

exp Any expression, whether sexp or aexp. 

lineno Line Number: A constant that identifies a particular program 

line in a deferred mode BASIC program. Must be any integer 
from through 32767. Line numbering determines the order of 
program execution. 

adata ATASCII Data: Any ATASCII character excluding commas and 

carriage returns. (See Appendix C.) 

filespec File Specification: A string expression that refers to a device 

such as the keyboard or to a disk file. It contains information on 
the type of I/O device, its number, a colon, an optional file name, 
and an optional filename extender. (See OPEN, Section 5.) 

Example filespec: "D1:NATALIE.ED" 



OPERATING 
MODES 
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Direct Mode: Uses no line numbers and executes instruction immediately after 
l;UJIH!l key is pressed. 

Deferred Mode: Uses line numbers and delays execution of instruction(s) until 
the RUN command is entered. 

Execute Mode: Sometimes called Run mode. After RUN command is entered, 
each program line is processed and executed. 

Memo Pad Mode: A non-programmable mode that allows the user to experi- 
ment with the keyboard or to leave messages on the screen. Nothing written 
while in Memo Pad mode affects the RAM-resident program. 



SPECIAL 

FUNCTION 

KEYS 



Vfi'NV 



Reverse (Inverse) Video key, or "ATARI LOGO KEY". Press- 
ing this key causes the text to be reversed on the screen (dark 
text on light background). Press key a second time to return to 
normal text. 

Lower Case key: Pressing this key shifts the screen characters 
from upper case (capitals) to lower case. To restore the characters 

to upper case, press the BHIIjJI key and the ■•nj-iiw/iTM key 
simultaneously. 

Escape key: Pressing this key causes a command to be entered 
into a program for later execution. 

Example: To clear the screen, you would enter: 

10 PRINT 



and press i.i=ii'i;i, , i . 

Escape is also used in conjunction with other keys to print special 
graphic control characters. See Appendix F and back cover for 
the specific keys and their screen-character representations. 
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Break key: Pressing this key during program execution causes 
execution to stop. Execution may be resumed by typing CONT 

followed by pressing i:i=mi:i:i . 

BBBBESfl System Reset key: Similar to E5SC1 in that pressing this key 
stops program execution. Also returns the screen display to 
Graphics mode 0, clears the screen, and returns margins and 
other variables to their default values. 

BBBBHI Tab key: Press ESQ and t h e E23E5Z3 keys simultaneously to 
set a tab. To clear a tab, press the EE3 and E5SHHH keys 
simultaneously. Used alone, fhe gH8arSCT» advances the cursor to 
the next tab position. In Deferred mode, set and clear tabs by 
preceding the above with a lin e num ber, the command PRINT, a 
quotation mark, and press the BB key. 



Examples: 

100 print " na una bbebi 

200 print " wrrm rmi ESESgll " 



Default tab settings are placed at columns 7, 15, 23, 31, and 39. 

BSB Insert key: Press the ESS9 and ■i:m;>* keys simultaneously to 

insert a line. To insert a single character, press the BBI an d 
keys simultaneously. 



GEE3n3IE Delete key: Press the tZJ and l.ldlJJJ keys simultaneously 

to dele te a line. To delete a single character, press EZ3 and 
" ~ simultaneously. 



B3BBE333B Back Space key: Pressing this key replaces the character to the 
left of the cursor with a space and moves cursor back one space. 

■•"*.!.■ Clea r key: Pressing this key while holding down the HBl m 

EEH key blanks the screen and puts the cursor in the upper left 
corner. 

■;<=»":■.'■ Return key: Terminator to indicate and end of a line of BASIC. 

Pressing this key causes a numbered line to be interpreted and 
added to a BASIC program RAM. An unnumbered line (in Direct 
mode) is interpreted and executed immediately. Any variables 
are placed in a variable table. 

ARITHMETIC The Atari Personal Computer System uses five arithmetic operators: 

OPERATORS 

+ addition (also unary plus; e.g., +5) 

- subtraction (also unary minus; e.g., -5) 

* multiplication 

/ division 

A exponentiation 



LOGICAL 

OPERATORS operator is NOT. The binary operators are: 



The logical operators consists of two types: unary and binary. The unary 
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sexp 

exp 
lineno 



adata 



filespec 



String Expression: Can consist of a string variable, string literal 
(constant), or a function that returns a string value. 

Any expression, whether sexp or aexp. 

Line Number: A constant that identifies a particular program 
line in a deferred mode BASIC program. Must be any integer 
from through 32767. Line numbering determines the order of 
program execution. 

ATASCII Data: Any ATASCII character excluding commas and 
carriage returns. (See Appendix C.) 

File Specification: A string expression that refers to a device 
such as the keyboard or to a disk file. It contains information on 
the type of I/O device, its number, a colon, an optional file name, 
and an optional filename extender. (See OPEN, Section 5.) 

Example filespec: "DlrNATALIE.ED" 



OPERATING 
MODES 



Direct Mode: Uses no line numbers and executes instruction immediately after 
l;UiN.I,'l key is pressed. 

Deferred Mode: Uses line numbers and delays execution of instruction(s) until 
the RUN command is entered. 

Execute Mode: Sometimes called Run mode. After RUN command is entered, 
each program line is processed and executed. 

Memo Pad Mode: A non-programmable mode that allows the user to experi- 
ment with the keyboard or to leave messages on the screen. Nothing written 
while in Memo Pad mode affects the RAM-resident program. 



SPECIAL 

FUNCTION 

KEYS 



EM] 



Reverse (Inverse) Video key, or "ATARI LOGO KEY". Press- 
ing this key causes the text to be reversed on the screen (dark 
text on light background). Press key a second time to return to 
normal text. 

Lower Case key: Pressing this key shifts the screen characters 
from upper case (capitals) to lower case. To restore the characters 

to upper case, press the TTTTjM key and the IEESEM key 
simultaneously. 

Escape key: Pressing this key causes a command to be entered 
into a program for later execution. 

Example: To clear the screen, you would enter: 

10 PRINT 

and press i:i=uu:i,'i . 

Escape is also used in conjunction with other keys to print special 
graphic control characters. See Appendix F and back cover for 
the specific keys and their screen-character representations. 
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Break key: Pressing this key during program execution causes 
execution to stop. Execution may be resumed by typing CONT 

followed by pressing i;mu;i:i . 



IA'MJdi',l;ljJ31 System Reset key: Similar to EHS3 in that pressing this key 
stops program execution. Also returns the screen display to 
Graphics mode 0, clears the screen, and returns margins and 
other variables to their default values. 

E3Z3E5B3 Tab key: Press gQB and theEaHEBXlkeys simultaneously to 
set a tab. To clear a tab, press the GUI and ESBESEJ keys 
simultaneously. Used alone, the H*&H:&W:B advances the cursor to 
the next tab position. In Deferred mode, set and clear tabs by 
preceding the above with a line number, the command PRINT, a 
quotation mark, and press fheOSBkey. 



Examples: 

100 print " na cnna ebbeeei " 

200 print " rea arm EEBB33I " 

Default tab settings are placed at columns 7, 15, 23, 31, and 39. 

1E331 Insert key: Press the EEBand ■i:t--n:f keys simultaneously to 

insert a line. To insert a single character, press the GJ3 and 
keys simultaneously. 



GEEUZZ3E Delete key: Press the EEB and 1-ldUJJ keys simultaneously 
to delete a line. To delete a single character, press t>n-.\n and 
simultaneously. 



EUaJDnSE Back Space key: Pressing this key replaces the character to the 
left of the cursor with a space and moves cursor back one space. 

n^Jii Clear key: Pressing this key while holding down the EH5B or 

laiilJ key blanks the screen and puts the cursor in the upper left 
corner. 

■:u»i:i.'" Return key: Terminator to indicate and end of a line of BASIC. 

Pressing this key causes a numbered line to be interpreted and 
added to a BASIC program RAM. An unnumbered line (in Direct 
mode) is interpreted and executed immediately. Any variables 
are placed in a variable table. 

ARITHMETIC The Atari Personal Computer System uses five arithmetic operators: 

OPERATORS 

+ addition (also unary plus; e.g., +5) 

- subtraction (also unary minus; e.g., -5) 

* multiplication 

/ division 

A exponentiation 

LOGICAL The logical operators consists of two types: unary and binary. The unary 

OPERATORS operator is NOT. The binary operators are: 
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AND Logical AND 
OR Logical OR 

Examples: 

19 IF A=12 AMD T=6 THEN PRINT "GOOD" 
10 A=<C>1> AND <N<!> 



10 A = <C+1) OR <N-1> 



10 A = NQTCC+1) 



Both expressions must 
be true before GOOD is 
printed. 

If both expressions 
true, A= + 1; otherwise 
A = 0. 

If either expression 
true, A = +1; otherwise 
A = 0. 

If expression is false, 
A= +1; otherwise A=0. 



The rest of the binary operators are relational. 

< The first expression is less than the second expression. 
> The first expression is greater than the second. 
= The expressions are equal to each other. 

< = The first expression is less than or equal to the second. 

> — The first expression is greater than or equal to the second. 

< > The two expressions are not equal to each other. 

These operators are most frequently used in IF/THEN statements and logical 
arithmetic. 



OPERATOR 
PRECEDENCE 



Operations within the innermost set of parentheses are performed first and pro- 
ceed out to the next level. When sets of parentheses are enclosed in another set, 
they are said to be "nested". Operations on the same nesting level are performed 
in the following order: 

Highest <,>,=,<=,>=,<-> Relational operators used in string expres- 
precedence sions. Have same precedence and are per- 

formed from left to right. 
Unary minus 
Exponentiation. 
* , / Multiplication and division have the same 

precedence level and are performed from left 
to right. 
+ , - Addition and subtraction have the same 

precedence level and are performed from left 
to right. 
<,>, = ,< =,>=,< > Relational operations in numeric expressions 
have the same precedence level from left to 
right. 
NOT Unary operator 

AND Logical AND 

Lowest OR Logical OR 

precedence 
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BUILT-IN 
FUNCTIONS 



The section titled FUNCTION LIBRARY explains the arithmetic and special 
functions incorporated into Atari BASIC. 



GRAPHICS 



Atari graphics include 9 graphics modes. The commands have been designed 
to allow maximum flexibility in color choice and pattern variety. Section 9 ex- 
plains each command and gives examples of the many ways to use each. 



SOUND AND 

GAMES 

CONTROLLERS 



The Atari Personal Computer is capable of emitting a large variety of sounds . 
including simulated explosions, electronic music, and "raspberries." Section 10 
defines the commands for using the SOUND function and for controlling pad- 
dle, joystick, and keyboard controllers. 



WRAPAROUND 
AND KEYBOARD 
ROLLOVER 



The ATARI Personal Computer System has screen wraparound thus allowing 
greater flexibility. It also allows the user to type one key ahead. If the user 
presses and holds any key, it will begin repeating after % second. 



ERROR 
MESSAGES 



If a data entry error is made, the screen display shows the line reprinted preced- 
ed by the message ERROR- and the offending character is highlighted. After 
correcting the character in the original line, delete the line containing the 
ERROR- before pressing l:l=MH:l,'l . Appendix B contains a list of all the error 
messages and their definitions. 
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COMMANDS 



Whenever the cursor (D) is displayed on the screen, the computer is ready to ac- 
cept input. Type the command (in either Direct or Deferred mode), and press 
■:iaiii:i,-i . This section describes the commands used to clear computer memory 
and other useful control commands: 

The commands explained in this section are the following: 



BYE 

CONT 

END 

LET 

LIST 



NEW 
REM 
RUN 
STOP 



BYE (B.) 



CONT (CON.) 



END 



Format: BYE 
Example: BYE 

The current function of the BYE command is to exit BASIC and put the com- 
puter in Memo Pad mode. This allows the user to experiment with the keyboard 
or to leave messages on the screen without disturbing any BASIC program in 
memory. To return to BASIC, press lA'MU'lilJJfl . 

Format: CONT 
Example: CONT 

Typing this command followed by a BHB causes program execution to 
resume. If a EEEQ3 , STOP, or END is encountered, the program will stop until 
CONT I.UJH:I?I is entered. Execution resumes at the next sequential line number 
following the statement at which the program stopped. 

Note: If the statement at which the program is halted has other comm ands on 
the same numbered line which were not executed at the time of the ■■i:i*m > 
STOP, or END, they will not be executed. On CONT, execution resumes at the 
next numbered line. A loop may be incorrectly executed if. the program is 
halted before the loop completes execution. 

This command has no effect in a Deferred mode program. 



Format: 
Example: 



END 

1000 END 



This command terminates program execution and is used in Deferred mode. In 
Atari BASIC, an END is not required at the end of a program. When the end of 
the program is reached, Atari BASIC automatically closes all files and turns off 
sounds (if any). END may also be used in Direct mode to close files and turn off 
sounds. 
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*~ ^ 



LET (LE.) 



LIST (L.) 



Format: [LET] var = exp 
Example: LET X = 3.142 * 1G 
LET X = 2 

This statement is optional in defining variables. It can just as easily be left out of 
the statement. It may be used, however, to set a variable name equal to a value. 



Format: 
Examples: 



LIST [lineno [ , lineno] ] 

LIST [filespec [ ,lineno [ ,lineno] ] ] 



LIST 
LIST 19 
LIST, 10, 198 

LIST "P.'S20, 106 

LIST "F" 

LIST "D^DEnO.LST" 



NEW 



This command causes the computer to display the source version of all lines cur- 
rently in memory if the command is entered without l ine num ber(s), or to 
display a specified line or lines. For example, LIST 10,100 ■=■=»■■='" displays lines 
10 through 100 on the screen. If the user has not typed the lines into the com- 
puter in numerical order, a LIST will automatically place them in order. 

Typing L."P will print the RAM-resident program on the printer. 

LIST can be used in Deferred mode as part of an error trapping routine (See 
TRAP in Section 4). 

The LIST command is also used in recording programs on cassette tape. The sec- 
ond format is used and a filespec is entered. (See Section 5 for more details on 
peripheral devices.) If the entire program is to be listed on tape, no line numbers 
need be specified. 

Example: LIST "CI" 

1000 LIST "CI" 

Format: NEW 
Example: NEW 

This command erases the program stored in RAM. Therefore, before typing 
NEW, either SAVE or CSAVE any programs to be recovered and used later. 
NEW clears BASIC'S internal symbol table so that no arrays (See Section 8) or 
strings (See Section 7) are defined. Used in Direct mode. 



R EM (R. or 

) 



SPACE 



Format: REM text 

Example: 10 REM ROUTINE TO CALCULATE X 

This command and the text following it are for the user's information only. It is 
ignored by the computer. However, it is included in a LIST along with the other 
numbered lines. Any statement on the same numbered line which occurs after a 
REM statement will be ignored. 



O, 
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RUN (RUJ 



Format: RUN [filespec] 
Examples: RUN 

RUN "D:MENU' 



This command causes the computer to begin executing a program. If no filespec 
is specified, the current RAM-resident program begins execution. If a filespec is 
included, the computer retrieves the specified, tokenized program from the 
specified file and executes it. 

All variables are set to zero and all open files and peripherals are closed. All ar- 
rays, strings, and matrices are eliminated and all sounds are turned off. Unless 
the TRAP command is used, an error message is displayed if any error is 
detected during execution and the program halts. 

RUN can be used in Deferred mode. 

Examples: 10 RRUfT "QUER AND OUER AGAIN." 
28 RUN 



STOP (STO.) 



Type RUN and press i:mn:u'i . To end, press 

To begin program execution at a point other than the first line number, type 
GOTO followed by the specific line number, then press|~ 



Format: 
Example: 



STOP 
100 STOP 



When the STOP command is executed in a program, BASIC displays the 

message STOPPED AT LINE , terminates program execution, and 

returns to Direct mode. The STOP command does not close files or turn off 
sounds, so the program can be resumed by typing CONT 
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NOTES 
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EDIT 
FEATURES 



In addition to the special function keys described in Section 1, there are cursor 
control keys that allo w imm edi ate ed iting capabilities. These keys are used in 
conjunction with the KlilUS or |*Uii9 keys. 

The following key functions are described in this section: 



1 
2 

O ESSi EE23 C03J 3 

EiB o ESSB ■"*«*<* ESS9 

gob a mssM E dmrnm ca 

SCREEN The keyboard and display are logically combined for a mode of operation 

EDITING known as screen editing. Each time a change is completed on the screen, the 

l:l:UII:l!l kev must be pressed. Otherwise, the change is not made to the program 

in RAM. 

Example: 18 REM PRESS RETURN hFTER LINE EDIT 



Kfc.1 i 
£d r K I N i 
7fi PRIhiT "THIS TC: ■ INE ■ ON THE 



•rkiNl 



To delete line 20 from the program, type the line number and press the 

key. Merely deleting the line from the screen display does not delete it from the 

program. 

The screen and keyboard as I/O devices are described in Section 5. 

Control key. Striking this key in conjunction with 
the arrow keys produces the cursor control functions 
that allow the user to move the cursor anywhere on 
the screen without changing any characters already 
on the screen. Other key combinations control the 
setting and clearing of tabs, halting and restarting 
program lists; and the graphics control symbols. 
Striking a key while holding the QD key will pro- 
duce the upper-left symbol on those keys having 
three functions. 

Shift key: This key is used in conjunction with the 
numeric keys to display the symbols shown on the 
upper half of those keys. It is also used in conjunction 
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DOUBLE-KEY 
FUNCTIONS 



with other keys to insert and delete lines, return to a 
normal, upper case letter display, and to display the 
function symbols above the subtraction, equals, addi- 
tion, and multiplication operators as well as the 
brackets, [ ], and question mark,?. 

Cursor Control Keys 

Moves cursor up one physical line without changing 
the program or display. 

Moves cursor one space to the right without disturb- 
ing the program or display. 

Moves cursor down one physical line without chang- 
ing the program or display. 

Moves cursor one space to the left without disturbing 
the program or display. 

Like the other keys on the Atari keyboard, holding the cursor control keys for 
more than M second causes the keys to repeat. 



Q 

o 

a 



2 
3 



■ i:ium ll.'Md.il 



eeeh 



Keys Used With 

Inserts one character space. 

Deletes one character or space. 

Stops temporarily and restarts screen display 
without "breaking out" of the program. 

Rings buzzer. 

Indicates end-of-file. 

Keys Used With 

Inserts one physical line. 

Deletes one physical line. 

Returns screen display to upper-case alphabetic 
characters. 

Special Function Keys 

Stops program execution or program list, prints a 
READY on the screen, and displays cursor. 

Allows commands normally used in Direct mode to 
be placed in Deferred mode; e.g., In Direct mode, 
BEB ■*"**:■ clears the screen display. To clear the 
screen in Deferred mode, type the following after the 

program line number. Press £3 then press 
and E13J together. 



PRINT " 



r 



14 Edit Features 



PROGRAM 
STATEMENTS 



This section explains the commands associated with loops, conditional and un- 
conditional branches, error traps, and subroutines and their retrieval. It also ex- 
plains the means of accessing data and the optional command used for defining 
variables. 

The following commands are described in this section: 

FOR, TO, STEP/NEXT IF/THEN POP 

GOSUB/RETURN ON, GOSUB RESTORE 

GOTO ON, GOTO TRAP 

FOR (F.), TO, Format: FOR avar = aexpl TO aexp2 [STEP aexp3] 

STEP/NEXT (N.) m . ^ ava T Tnin 

Examples: FOR X = 1 TO 10 
NEXT X 

FOR Y = 10 TO 20 STEP 2 
NEXT Y 

FOR INDEX = Z TO 100 * Z 
NEXT INDEX 

This command sets up a loop and determines how many times the loop is exe- 
cuted. The loop variable (avar) is initialized to the value of aexpl. Each time the 
NEXT avar statement is encountered, the loop variable is incremented by the 
aexp3 in the STEP statement. The aexp3 can be positive or negative integers, 
decimals, or fractional numbers. If there is no STEP aexp3 command, the loop 
increments by one. When the loop completes the limit as defined by aexp2, it 
stops and the program proceeds to the statement immediately following the 
NEXT statement; it may be on the same line or on the next sequential line. 

Loops can be nested, one within another. In this case, the innermost loop is com- 
pleted before returning to the outer loop. The following example illustrates a 
nested loop program. 



19 FOR x= 


=1 TO 3 






20 PRINT 


"OUTER 


LOOP' 


t 


30 2=0 








40 2=2+2 








50 FOR Y= 


=1 TO 5 


;-, i hp 


—7 


60 PRINT 


II TI 
11 


n. if-n i 

ficK i. 


.OOP' 


70 NEXT 'i 








86 NEXT ) 


f 






90 END 









Figure 4-1. Nested Loop Program 
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In Figure 4-1, the outer loop will complete three passes ( X = 1 to 3 ). However, 
before this first loop reaches its NEXT X statement, the program gives control to 
the inner loop. Note that the NEXT statement for the inner loop must precede 
the NEXT statement for the outer loop. In the example, the inner loop's number 
of passes is determined by the STEP statement (STEP Z). In this case, Z has 
been defined as 0, then redefined as Z + 2. Using this data, the computer must 
complete three passes through the inner loop before returning to the outer loop. 
The aexp3 in the step statement could also have been defined as the numerical 
value 2. 

The program run is illustrated in Figure 4-2. 



OUTER LOOP 

INNER LOOP 
INNER LOOP 
INNER LOOP 

OUTER LOOP 

INNER LOOP 
INNER LOOP 
INNER LOOP 

OUTER LOOP 

INNER LOOP 
INNER LOOP 
INNER LOOP 



Figure 4-2. Nested Loop Execution 

The return address for the loops are placed in a special group of memory ad- 
dresses referred to as a stack. The information is "pushed" on the stack and 
when used, the information is "popped" off the stack (see POP.) 



GOSUB (GOS.) 
RETURN (RET.) 



Format: GOSUB lineno 

lineno 

RETURN 
Example: 100 GOSUB 2000 

2000 PRINT "SUBROUTINE" 

2010 RETURN 



A subroutine* is a program or routine used to compute a certain value, etc. It is 
generally used when an operation must be replaced several times within a pro- 
gram sequence using the same or different values. This command allows the 
user to "call" the subroutine 1 , if necessary. The last line of the subroutine must 
contain a RETURN statement. The RETURN statement goes back to the physical 
line following the GOSUB statement. 

Like the preceding FOR/NEXT command, the GOSUB/RETURN command 
uses a stack for its return address. If the subroutine is not allowed to complete 
normally; e.g., a GOTO lineno before a RETURN, the GOSUB address must be 
"popped" off the stack (see POP) or it could cause future errors. 



Generally, a subroutine can do anything that can be done in a program. It is used to save memory 
and program-entering time, and to make programs easier to read and debug. 
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To prevent accidental triggering of a subroutine (which normally follows the 
main program), place an END statement preceding the subroutine. The follow- 
ing program demonstrates the use of subroutines. 



10 PRINT ■}" 

20 REM EXAMPLE USE OF GOSUB/RETURN 

39 X=100 

40 GOSUB 100U' 



(Clear screen) 



50 X=12@ 




60 GOSUB 


1000 


79 y=5y 




80 GOSUB 




90 END 




1000 Y=3< 


:'':■:' 


1010 X*X+Y 


1020 PRtt 


(T 1 J II 

1 ! .•'■. 1 I 


1039 RETL 


.iKi i 



Figure 4-3. GOSUB/RETURN Program Listing 



In the above program, the subroutine, beginning at line 1000, is called three 
times to compute and print out different values of X and Y. Figure 4-4 illustrates 
the results of executing this program. 



460 


380 


438 


360 


200 


150 



Figure 4-4. GOSUB/RETURN Program Run 



GOTO (G.) 



aexp 



Format: I GO TO ' 

(GOTO 
Examples: 100 GOTO 50 

500 GOTO (X + Y) 



The GOTO command is an unconditional branch statement just like the GOSUB 
command. They both immediately transfer program control to a target line 
number or arbitrary expression. However, using anything other than a con- 
stant will make renumbering the program difficult. If the target line number is 
non-existent, an error results. Any GOTO statement that branches to a 
preceding line may result in an "endless" loop. Statements following a GOTO 
statement will not be executed. Note that a conditional branching statement (see 
IF/THEN)can be used to break out of a GOTO loop. The following program il- 
lustrates two uses of the GOTO command. 
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18 PRINT 

28 PRINT : PRINT "ONE" 

38 PRINT "TUB" 

48 PRINT "THREE" 

58 PRINT "FOUR" 

68 PRINT "FIUE" 
65 GOTO 188 

78 print "m$m$$$$$nm u 

90 PRINT " •?•?•?■???•???■?•?•??•????» 

95 END 

100 PRINT "SIX" 

118 PRINT "SEUEN" 

128 PRINT "EIGHT" 

138 PRINT "NINE" 

148 PRINT "TEN" 

158 GOTO 78 



Figure 4-5. GOTO Program Listing 

Upon execution, the numbers in the above listing will be listed first followed by 
the three rows of symbols. The symbols listed on lines 70, 80, and 90 are ignored 
temporarily while the program executes the GOTO 100 command. It proceeds 
with the printing of the numbers "SIX" through "TEN", then executes the se- 
cond GOTO statement which transfers program control back to line 70. (This is 
just an example. This program could be rewritten so that no GOTO statements 
were used.) The program, when executed, looks like the following: 



ONE 
TWO 

THREE 

FOUR 

FIUE 
o t y 

SEUEH 

EIGHT 

NINE 

TEN 

$$$$$$$$$$$$$$$$$ 



u .i .m.m .m . 



.3 .m .a .» .a .a . 



IF/THEN 



Figure 4-6. GOTO Program Run 



,,) 



Format: IF aexp THEN I lineno 

I statement [statement. 
Examples: IF X = 100 THEN 150 

IF A$ = "ATARI" THEN 200 

IF AA = 145 and BB = 1 THEN PRINT AA, BB 

IF X = 100 THEN X = 
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The IF/THEN statement is a conditional branch statement. This type of branch 
occurs only if certain conditions are met. These conditions may be either 
arithmetical or logical. If the aexp following the IF statement is true (non-zero), 
the program executes the THEN part of the statement. If, however, the aexp is 
false (a logical 0), the rest of the statement is ignored and program control passes 
to the next numbered line. 



In the format, IF aexp THEN lineno, lineno must be a constant, not an expression 
and specifies the line number to go to if the expression is true. If several 
statements occur after the THEN, separated by colons, then they will be ex- 
ecuted if and only if the expression is true. Several IF statements may be nested 
on the same line. For example: 

198 IF X=5 ThEN IF Y=3 THEN R=9^G0T0288 

The statements R = 9: GOTO 100 will be executed only if X = 5 and Y = 3. The 
statement Y = 3 will be executed if X = 5. 

The following program demonstrates the IF/THEN statement. 



5 GRAPHICS 8=? ■•? " IF DEMO" 
18 ? =? "ENTER ft"; = INPUT A 

28 IF A=l THEN 40: REM MULTIPLE STATEMENT 

S HERE WILL NEUER BE EXECUTED! I 

30 ? =? "A IS NOT 1. EXECUTION CONTINUE 

S HERE WHEN THE EXPRESSION IS FALSE." 

40 IF A=l THEN ? =? "A=l":? "YES, IT IS 

REALLY l.":REri MULTIPLE STATEMENTS HERE 

WILL BE EXECUTED ONLY IF A=l I ! 

50 ? =? "EXECUTION CONTINUES HERE IF A<> 

1 OR AFTER 'YES, IT IS REALLY 1' IS DISP 

LAVED." 

60 GOTO 10 



Figure 4-7. IF/THEN Program 

ENTER A 

A IS NOT 1. EXECUTION CONTINUES HERE WH 

EN THE EXPRESSION IS FALSE. 

EXECUTION CONTINUES HERE IF AOl OR AFTE 

R 'YES, IT IS REALLY 1' IS DISPLAYED. 

ENTER A 

A=l 

YES, IT IS REALLY 1. 

EXECUTION CONTINUES HERE IF AOl OR AFTE 

R 'YES, IT IS REALLY 1' IS DISPLAYED. 

ENTER A 



(entered 2) 



(entered 1) 



Figure 4-8. IF/THEN Program Execution. 



Program Statements 19 



ON/GOSUB/ 

RETURN 

ON/GOTO 



Format: ON aexp I GOTO 1 lineno [ ,lineno...] 

| GOSUB j 
Examples: 100 ON X GOTO 200, 300, 400 

100 ON A GOSUB 1000, 2000 

100 ON SQR(X) GOTO 30, 10, 100 

Note: GOSUB and GOTO may not be abbreviated. 

These two statements are also conditional branch statements like the IF/THEN 
statement. However, these two are more powerful. The aexp must evaluate to a 
positive number which is then rounded to the nearest positive integer (whole 
number) value up to 255. If the resulting number is 1, then program control 
passes to the first lineno in the list following the GOSUB or GOTO. If the 
resulting number is 2, program control passes to the second lineno in the list, 
and so on. If the resulting number is or is greater than the number of linenos 
in the list, the conditions are not met and program control passes to the next 
statement which may or may not be located on the same line. With ON/GOSUB, 
the selected subroutine is executed and then control passes to the next state- 
ment. 

The following routine demonstrates the ON/GOTO statement: 

18 x=x+i 

26 ON X GOTO 180,290,300,400,500 
30 IF X>5 THEN PRINT "COMPLETE.": END 

40 GOTO 10 

50 END 

100 PRINT "NOW WORKING AT LINE 100" ■GOTO 

16 
200 PRINT "NOW WORKING AT LINE 200"= GOTO 

18 
300 PRINT "NOW WORKING AT LINE 300": GOTO 

18 
400 PRINT "NOW WORKING AT LINE 408" = GOTO 

10 

588 PRINT "NOW WORKING AT LINE 500"= GOTO 
10 

Figure 4-9 ON/GOTO Program Listing 

When the program is executed, it looks like the following: 
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NOW WORKING AT LINE 100 

NOW WORKING AT LINE 200 

NOW WORKING AT LINE 300 

NOW WORKING AT LINE 400 

NOW WORKING AT LINE 508 
COMPLETE. 



POP 



Figure 4-10 ON/GOTO Program Execution 



Format: 
Example: 



POP 
1000 POP 



\ 



In the description of the FOR/NEXT statement, the stack was defined as a group 
of memory addresses reserved for return addresses. The top entry in the stack 
controls the number of loops to be executed and the RETURN target line for a 
GOSUB. If a subroutine is not terminated by a RETURN statement, the top 
memory location of the stack is still loaded with some numbers. If another 
GOSUB is executed, that top location needs to be cleared. To prepare the stack 
for a new GOSUB, use a POP to clear the data from the top location in the stack. 

The POP command must be used according to the following rules: 

1. It must be in the execution path of the program. 

2. It must follow the execution of any GOSUB statement that is not brought 
back to the main program by a RETURN statement. 

The following example demonstrates the use of the POP command with a 
GOSUB when the RETURN is not executed: 

10 GOSUB 1888 

15 REM LINE 28 WILL NOT BE EXECUTED 

28 PRINT "NORMAL RETURN PRINTS THIS MESS 

AGE . " 

30 PRINT "ABNORMAL RETURN PRINTS THIS ME 

SSAGE." 

40 POP 

999 END 

1888 PRINT "NOW EXECUTING SUBROUTINE." 

1818 GOTO 38 

1028 RETURN 

Figure 4-11. GOSUB Statement With POP 



RESTORE (RES.) Format: RESTORE [aexp] 

Example: 100 RESTORE 

The Atari Personal Computer System contains an internal "pointer" that 
keeps track of the DATA statement item to be read next. Used without the op- 
tional aexp, the RESTORE statement resets that pointer to the first DATA item 
in the program. Used with the optional aexp, the RESTORE statement sets the 
pointer to the first DATA item on the line specifed by the value of the aexp. This 
statement permits repetitive use of the same data. 

19 FOR N=l TO 2 

28 READ A 

38 RESTORE 

48 READ B 

58 M=A+B 

68 PRINT "TOTAL EQUALS ";M 

78 NEXT N 

88 END 

98 DATA 30, 15 

Figure 4-12. Restore Program Listing 

,*» On the first pass through the loop, A will be 30 and B will be 30 so the total line 

50 will print SUM TOTAL EQUALS 60, but on the second pass, A will equal 15 
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and B, because of the RESTORE statement, will still equal 30. Therefore, the 
PRINT statement in line 50 will display SUM TOTAL EQUALS 45. 



TRAP (T.) Format: TRAP aexp 

Example: 100 TRAP 120 



The TRAP statement is used to direct the program to a specified line number if 
an error is detected. Without a TRAP statement, the program stops executing 
when an error is encountered and displays an error message on the screen. 

The TRAP statement works on any error that may occur after it has been ex- 
ecuted, but once an error has been detected and trapped, it is necessary to reset 
the trap with another TRAP command. This TRAP command may be placed at 
the beginning of the section of code that handles input from the keyboard so 
that the TRAP is reset after each error. PEEK(195) will give you an error 
message (see Appendix B). 256*PEEK(187) + PEEK(186) will give you the number 
of the line where the error occurred. The TRAP may be cleared by executing a 
TRAP statement with an aexp whose value is from 32767 to 65535 (e.g., 40000). 
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INPUT/OUTPUT 
COMMANDS AND DEVICES 



This section describes the input/output devices and how data is moved between 
them. The commands explained in this section are those that allow access to the 
input/output devices. The input commands are those associated with getting 
data into the RAM and the devices geared for accepting input. The output com- 
mands are those associated with retrieving data from RAM and the devices 
geared for generating output. 



The commands described in this section are: 



INPUT/OUTPUT 
DEVICES 



CLOAD 


INPUT 


OPEN/CLOSE 


READ/DATA 


CSAVE 


LOAD 


POINT 


SAVE 


DOS 


LPRINT 


PRINT 


STATUS 


ENTER 


NOTE 


PUT/GET 


XIO 



The hardware configuration of each of the following devices is illustrated in the 
individual manuals furnished with each. The Central Input/Output (CIO) sub- 
system provides the user with a single interface to access all of the system 
peripheral devices in a (largely) independent manner. This means there is a 
single entry point and a device-independent calling sequence. Each device has a 
symbolic device name used to identify it; e.g., K: for the keyboard. Each device 
must be opened before access and each must be assigned to an Input/Output Con- 
trol Block (IOCB). From then on, the device is referred to by its IOCB number. 

ATARI BASIC contains 8 blocks in RAM which identifies to the Operating 
System the information it needs to perform an I/O operation. This information 
includes the command, buffer length, buffer address, and two auxiliary control 
variables. ATARI BASIC sets up the IOCB's, but the user must specify which 
IOCB to use. BASIC reserves IOCB #0 for I/O to the Screen Editor, therefore the 
user may not request IOCB #0. The GRAPHICS statement (see Section 9) opens 
IOCB #6 for input and output to the screen. (This is the graphics window S:). 
IOCB #7 is used by BASIC for the LPRINT, CLOAD, and CSAVE commands. The 
IOCB number may also be referred to as the device (or file) number. IOCB's 1 
through 5 are used in opening the other devices for input/output operations. If 
IOCB #7 is in use, it will prevent LPRINT or some of the other BASIC I/O 
statements from being performed. 

Keyboard: (K:) Input only device. The keyboard allows the user to read the 
converted (ATASCII) keyboard data as each key is pressed. 

Line Printer: (P:) Output only device. The line printer prints ATASCII 
characters, a line at a time. It recognizes no control characters. 

Program Recorder: (C:) Input and Output device. The recorder is a read/write 
device which can be used as either, but never as both simultaneously. The 
cassette has two tracks for sound and program recording purposes. The audio 
track cannot be recorded from the ATARI system, but may be played back 
through the television speaker. 



I/O Commands and Devices 23 



Disk Drives: (Dl:, D2:, D3:, D4:) Input and Output devices. If 1GK of RAM is 

installed, the ATARI can use from one to four disk drives. If only one disk drive 
is attached, there is no need to add a number after the symbolic device code D. 

Screen Editor: (E:) Input and Output device. This device uses the keyboard 
and display (see TV Monitor) to simulate a screen editing terminal. Writing to 
this device causes data to appear on the display starting at the current cursor 
position. Reading from this device activates the screen editing process and 
allows the user to enter and edit data. Whenever the EdEEEIkey is pressed, the 
entire logical line within which the cursor resides is selected as the current 
record to be transferred by CIO to the user program. (See Section 9). 

TV Monitor: (S:) Input and Output device. This device allows the user to read 
characters from and write characters to the display, using the cursor as the 
screen addressing mechanism. Both text and graphics operations are supported. 
See Section 9 for a complete description of the graphics modes. 

Interface, RS-232: (R:) The RS-232 device enables the ATARI system to inter- 
face with RS-232-compatible devices such as printers, terminals, and plotters. It 
contains a parallel port to which the 80-column printer (ATARI 825™) can be at- 
tached. 



r^ 



CLOAD (CLOA.) 



Format: 
Examples: 



CLOAD 
CLOAD 

100 CLOAD 



This command can be used in either Direct or Deferred mode to load a program 
from cassette tape into RAM for execution. On entering CLOAD, one bell rings 
to indicate that the PLAY button needs to be pressed followed by manum . 
However, do not press PLAY until after the tape has been positioned. Specific in- 
structions for CLOADing a program are contained in the ATARI 410 Program 
Recorder Manual. Steps for loading oversized programs are included in the 
paragraphs under CHAINING PROGRAMS at the end of this section. 



CSAVE (CS.) 



Format: CSAVE 
Examples: CSAVE 

100 CSAVE 
100 CS. 



This command is usually used in Direct mode to save a RAM-resident program 
onto cassette tape. CSAVE saves the tokenized version of the program. On enter- 
ing CSAVE two bells ring to indicate that the PLAY and RECORD buttons must 
be pressed followed by l;UiH:l,'l . Do not, however, press these buttons until the 
tape has been positioned. It is faster to save a program using this command 
rather than a SAVE "C" (see SAVE) because short inter-record gaps are used. 

Notes: Tapes saved using the two commands, SAVE and CSAVE, are not com- 
patible 

It may be necessary to enter an LPRINT (see LPRINT) before using 
CSAVE. Otherwise, CSAVE may not work properly. 

For specific instructions on how to connect and operate the hardware, 
cue the tape, etc., see the ATARI 410 Program Recorder Manual. 
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DOS (DO.) 



ENTER (E.) 



Format: DOS 
Example: DOS 

The DOS command is used to go from BASIC to the Disk Operating System 
(DOS). If the Disk Operating System has not been booted into memory, the com- 
puter will go into Memo Pad mode and the user must press ^HHISaJ to return 
to Direct mode. If the Disk Operating System has been booted;, the DOS Menu is 
displayed. To clear the DOS Menu from the screen, press ^EEZEBli Control 
then passes to BASIC. Control can also be returned to BASIC by selecting B (Run 
Cartridge) on the DOS Menu. 

The DOS command is usually used in Direct mode; however, it may be used in a 
program. For more details on this, see the Atari DOS Manual. 

Format: ENTER filespec 
Examples: ENTER "C 

ENTER "D:DEMOPR.INS" 



INPUT (I.) 



This statement causes a cassette tape to play back a program originally recorded 
using LIST (see Section 2, LIST). The program is entered in unprocessed (un- 
tokenized) form, and is interpreted as the data is received. When the loading is 
complete, it may be run in the normal way. The ENTER command may also be 
used with the disk drive. Note that both LOAD and CLOAD (see Section 2) clear 
the old program from memory before loading the new one. ENTER merges the 
old and new programs. This ENTER statement is usually used in Direct mode. 

Format: INPUT |_#aexp { ; jj | svar ) |_, { svar j -J 
Examples: 100 INPUT X 

100 INPUT N$ 

100 PRINT "ENTER THE VALUE OF X" 

110 INPUT X 



This statement requests keyboard data from the user. In execution, the com- 
puter displays a ? prompt when the program encounters an INPUT statement. It 
is usually preceded by a PRINT statement that prompts the user as to the type of 
information being requested. 

String variables are allowed only if they are not subscripted. Matrix variables 
are not allowed. 

The #aexp is optional and is used to specify the file or device number from 
which the data is to be input (see Input/Output Devices). If no #aexp is specified, 
then input is from the screen editor (E:). 

If several strings are to be input from the screen editor, type one string, press 

■:i=mi:i,'i , type the next string, i:i*m;i:i , etc. Arithmetic numbers can be typed on 
the same line separated by commas. 



18 PRINT "ENTER 5 NUMBERS TO BE SUMMED" 

28 FOR N=i TO 5 

38 INPUT X 

40 C=C+X 

58 NEXT N 

68 PRINT "THE SUM OF YOUR: NUMBERS IS ";C 

78 END 

Figure 5-1 Input Program Listing 



I/O Commands and Devices 25 



LOAD (LO.) 



Format: LOAD filespec 
Example: LOAD "D1JANINE.BRY" 

This command is similar to CLOAD except the full file name system can be used. 
LOAD uses long inter-record gaps on the tape (see CLOAD) and uses the token- 
ized version of the program. When using only one disk drive, it is not necessary 
to specify a number after the "D" because the default is disk drive #1. 



LPRINT (LP.) 



][{;) exp...] 



Format: LPRINT [exp] |_ (, j exp... 
Example: LPRINT "PROGRAM TO CALC 
100 LPRINT X;" ";Y;" ";Z 



This statement causes the computer to print data on the line printer rather than 
on the screen. It can be used in either Direct or Deferred modes. It requires no 
device specifier and no OPEN or CLOSE statement. (BASIC uses IOCB #7.) 



The above program listing illustrates a program that will add 5 numbers 
entered by the user. To print a program listing on the line printer, see LIST. 



NOTE (NO.) 



Format: NOTE #aexp, avar, avar 
Example: 100 NOTE #1, X, Y 

This command is used to store the current disk sector number in the first avar 
and the current byte number within the sector in the second avar. This is the 
current read or write position in the specified file where the next byte to be 
read or written is located. This NOTE command is used when writing data to a 
disk file (see POINT). The information in the NOTE command is written into a 
second file which is then used as an index into the first file. 



OPEN (O.) 
CLOSE (CL.) 



Formats: OPEN #aexp,aexpl,aexp2, filespec 

CLOSE #aexp 
Examples: 100 OPEN #2,8,0,"D1:ATARI800.BAS" 

100 A$ = "D1:ATARI800.BAS" 

110 OPEN #2,8,0,A$ 

150 CLOSE #2 

Before a device can be accessed, it must be opened. This "opening" process links 
a specific IOCB to the appropriate device handler, initializes any ClO-related con- 
trol variables, and passes any device-specific options to the device handler. The 
parameters for the OPEN command are defined as follows: 

# Mandatory character that must be entered by the 



aexp Reference IOCB or file number to same parameters 

for future use (as in CLOSE command). Number 
may be 1 through 7. 
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aexpl Code number to determine input or output opera- 

tion. 

Code 4 =» input operation 

8 = output operation 

12 = input and output operation 
6 = disk directory input operation 

(In this case, the filespec is the search specifica- 
tion.) 

9 = end-of-file append (output) operation. Append is 

also used for a special screen editor input mode. 
This mode allows a program to input the next 
line from E: without waiting for the user to press 
IJiUllfLI 

aexp2 Device-dependent auxiliary code. An 83 in this 

parameter indicates sideways printing on a printer 
(see appropriate manuals for control codes). 

filespec Specific file designation. Must be enclosed in quota- 

tion marks. The format for the filespec parameter 
is shown in Figure 5-2. 



Device 

Code 

Device 

Number 
(optional) 

Required 

Colon 

File name 

(up to 8 
characters- 
must begin 
with alphabetic 
character) 

Period required - 
as separator if 
extender is used. 

Extender 

(optional)- 

Includes 

0-3 characters 



"D1:ATARI800.BAS" 

—* 4 4' 



Note: Filenames are 
not used with 
the program 
recorder. 



Figure 5-2 Filename Breakdown 

The CLOSE command simply closes files that have been previously opened with 
an OPEN command. Note in the example that the aexp following the mandatory 
# character must be the same as the aexp reference number in the OPEN state- 
ment. 
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POINT (P.) 



// 



PRINT (PR or ?) 



Format: POINT #aexp, avar, avar 
Example: 100 POINT #2, A,B 

This command is used when reading a file into RAM. The first avar specifies the 
sector number and the second avar specifies the byte within that sector where 
the next byte will be read or written. Essentially, it moves a software-controlled 
pointer to the specified location in the file. This gives the user "random" access 
to the data stored on a disk file. The POINT and NOTE commands are discussed 
in more detail in the DOS Manual. 



Format: 
Examples: 



u 



PRINT [#aexp] ( , J [exp] [,exp...] 

PRINT X, Y, Z, A$ 

100 PRINT "THE VALUE OF X IS ";X 

100 PRINT "COMMAS", "CAUSE", "COLUMN", "SPACING' 

100 PRINT #3, A$ 



PUT(PU.)/ 
GET(GE.) 



A PRINT command can be used in either Direct or Deferred mode. In Direct 
mode, this command prints whatever information is contained between the 
quotation marks exactly as it appears. In the first example, PRINT X,Y,Z,A$, the 
screen will display the current values of X,Y,Z, and A$ as they appear in the 
RAM-resident program. In the last example, PRINT #3,A$, the #3 is the file 
specifier (may be any number between 1 and 7) that controls to which device 
the value of A$ will be printed. (See Input/Output Devices.) 

A comma causes tabbing to the next tab location. Several commas in a row cause 
several tab jumps. A semicolon causes the next aexp or sexp to be placed im- 
mediately after the preceding expression with no spacing. Therefore, in the 
second example a space is placed before the ending quotation mark so the value 
of X will not be placed immediately after the word "IS". If no comma or 
semicolon is used at the end of a PRINT statement, then a l:UiH:l,'l is output and 
the next PRINT will start on the following line. 



Format: 



Examples: 



PUT #aexp, aexp 
GET #aexp, 
100 PUT #6, ASCC'A") 
200 GET #1,X 



READ (REA.) 
DATA (D.) 



The PUT and GET are opposites. The PUT command ^outputs a single byte from 
0-255 to the file specified by #aexp. (# is a mandatory character in both these 
commands). The GET command reads one byte from 0-255 (using #aexp to 
designate the file, etc. on diskette or elsewhere) and then stores the byte in the 
variable avar. 



Formats: READ var [ , var...] 

DATA adata [ , adata...] 
Examples: 100 READ A,B,C,D,E 

110 DATA 12,13,14,15,16 

100 READ A$,B$,C$,D$,E$ 

110 DATA EMBEE, EVELYN, CARLA, CORINNE, BARBARA 



These two commands are always used together and the DATA statement is 
always used in Deferred mode 1 . The DATA statement can be located anywhere 

■A Direct mode READ will only read data if a DATA statement was executed in the program. 
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in the program, but must contain as many pieces of data as there are defined in 
the READ statement. Otherwise, an "out of data" error is displayed on the 
screen. 

String variables used in READ statements must be dimensioned and cannot be 
subscripted. (See STRINGS Section). Neither may array variables may be used in 
a READ statement. 

The DATA statement holds a number of string data for access by the READ 
statement. It cannot include arithmetical operations, functions, etc. Further- 
more, the data type in the DATA statement must match the variable type de- 
fined in the corresponding READ statement. 

The following program totals a list of numbers in a DATA statement: 



10 FOR H=l TO 5 

28 READ 

30 M=M+D 

40 NEXT N 

50 PRINT "SUT1 TOTAL EQUALS ";?1 

60 END 

70 DATA 30,15,106,17,87 



n 



Figure 5-3 Read/Data Program Listing 

The program, when executed, will print the statement: 

SUM TOTAL EQUALS 255. 



SAVE (S.) 



Format: SAVE filespec 

Example: SAVE "Dl:YVONNE.PAT" 

The SAVE command is similar to the CSAVE command except that the full file 
name system can be used. The device code number is optional when using only 
one disk drive. The default is to disk drive #1. SAVE, like LOAD, uses long inter- 
record gaps on the cassette (see CSAVE) and the tokenized form of the program. 



STATUS (ST.) 



Format: 
Example: 



STATUS #aexp,avar 
350 STATUS #1,Z 



The STATUS command calls the STATUS routine for the specified device (aexp). 
The status of the STATUS command (see ERROR MESSAGES, Appendix B) is 
stored in the specified variable (avar). This may be useful for future devices such 
as the RS-232 interface. 



XIO (X.) 



Format: XIO cmdno, #aexp, aexpl, aexp2, filespec 
Example: XIO 18,#6,0,0,"S:" 

The XIO command is a general input/output statement used for special opera- 
tions. One example is its use to fill an area on the screen between plotted points 
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/ 



/ 






and lines with a color (see Section 9). The parameters for this command are de- 
fined as follows: 

cmdno Number that stands for the particular command to 

be performed. 



aexp 

aexpl 
aexp2 



EXAMPLE 

Same as BASIC OPEN 

These 4 commands are similar to 

BASIC INPUT GET, PRINT, and PUT 

respectively. 

Same as BASIC CLOSE 

Same as BASIC STATUS 

Same as BASIC DRAWTO 

See Section 9 

XIO 32,#1,0,0,"D:TEMP.CAROL" 

XIO 33,#1,0,0,"D:TEMP.BAS" 

XIO 35,#1,0,0,"D:TEMP.BAS" 

XIO 36,#1,0,0,"D:TEMP.BAS" 

Same as BASIC POINT 

Same as BASIC NOTE 

XIO 254,#1,0,0,"D2:" 



Device number (same as in OPEN). Most of the time 
it is ignored, but must be preceded by #. 

Two auxiliary control bytes. Their usage 
depends on the particular device and command. In 
most cases, they are unused and are set to 0. 



cmdiK 


3 OPERATION 


3 


OPEN 


5 


GET RECORD 


7 


GET CHARACTERS 


9 


PUT RECORD 


11 


PUT CHARACTERS 


12 


CLOSE 


13 


STATUS REQUEST 


17 


DRAW LINE 


18 


FILL 


32 


RENAME 


33 


DELETE 


35 


LOCK FILE 


3G 


UNLOCK FILE 


37 


POINT 


38 


NOTE 


254 


FORMAT 



filespec String expression that specifies the device. Must be 

enclosed in quotation marks. Although some com- 
mands, like Fill (Section 9), do not look at the 
filespec, it must still be included in the statement. 



CHAINING 
PROGRAMS 



If a program requires more memory than is available, use the following steps to 
string programs of less than the maximum memory available into one program. 

Type in the first part of the program in the normal way. 

The last line of the first part of the. program should contain only the line 

number and the command RUN"C:" 

Cue the tape to the blank section. Write down the program counter number 

for later RUN purposes. Press PLAY and RECORD buttons o.n the deck so that 

both remain down. 

Type SAVE"C:" and press l:l=WIU'l . 

When the beeping sound occurs, press E8E38 again. 

When the screen displays "READY", do not move tape. Type NEW l;UW:l!l . 

Repeat the above instructions for the second part of the program. 

As the second part of the program is essentially a totally new program, it is 

possible to re-use the line numbers used in the first part of the program. 

If there is a third part of the program, make sure the last line of the second 

part is a RUN"C:" command. 



1. 
2. 



4. 
5. 
6. 
7. 
8. 

9. 
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L_ 



To execute a "chained" program, use the following steps: 

1. Cue the tape to the beginning of part 1 of the program. 

2. Press PLAY button on the recorder. 

3. Type RUN"C:"E2!lini ■ 

4. When the "beep" sounds, press QSQiIZI again. 

The computer automatically loads the first part of the p rogram , runs it, and 
sounds a "beep" to indicate when to hit the space bar or i;i=unn« to trigger the 
tape motor for the second LOAD/RUN. The loading takes a few seconds. 

Note: A one-part program can be recorded and reloaded in the same way or 
CSAVE and CLOAD can be used. 

Note: Remember to boot DOS before typing in your program. 

MODIFYING A The procedure for modifying an existing BASIC program stored on a diskette is 

BASIC PROGRAM demonstrated in the following steps: 

ON DISK i. Turn off ATARI console and insert BASIC cartridge. 

2. Connect disk drive and turn it on - without inserting diskette. 

3. Wait for Busy Light to go out and for the drive to stop. Open disk drive door. 

4. Insert diskette (with DOS) and close door. 

5. Turn on console. DOS should boot in and the screen show READY. 

6. To load program from disk, type 

LOAD "D:filename.ext 

7. Modify program (or type in new program) . 

8. To save program on disk, type 

SAVE "D:filename.ext 

9. Always wait for the Busy light to go out before removing diskette. 

10. To get a Directory listing, do not remove diskette and type 

DOS 
Upon EBB , the DOS Menu will be displayed. Select command letter A, 
type it, and press I.UiH.I.'l twice to list the dir ectory on the screen; or type A 
followed by pressing BBfll then P: liUM;!. 1 ! to list direc tory on the printer. 

11. To return to BASIC, type B ESEZI or press BHBSBBH • 



n 



c 
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FUNCTION 
LIBRARY 



ARITHMETIC 
FUNCTIONS 

ABS 



CLOG 



This section describes the arithmetic, trigonometric, and special purpose func- 
tions incorporated into the ATARI BASIC. A function performs a computation 
and returns the result (usually a number) for either a print-out or additional 
computational use. Included in the trigonometric functions are two statements, 
radians (RAD) and degrees (DEG), that are frequently used with trigonometric 
functions. Each function described in this section may be used in either Direct 
or Deferred mode. Multiple functions are perfectly legal. 

The following functions and statements are described in this section: 



ABS 

CLOG 

EXP 

INT 

LOG 

RND 

SGN 

SQR 



ATN 


ADR 


COS 


FRE 


SIN 


PEEK 


DEG/RAD 


POKE 




USR 



Format: 
Example: 



ABS(aexp) 

100 AB = ABS (-190) 



Returns the absolute value of a number without regard to whether it is positive 
or negative. The returned value is always positive. 

Format: CLOG (aexp) 
Example: 100 C = CLOG(83) 

Returns the logarithm to the base 10 of the variable or expression in paren- 
theses. CLOG(0) should give an error and CLOG(l) should be 0. 



EXP 



Format: 
Example: 



EXP (aexp) 

100 PRINT EXPO) 



Returns the value of e (approximately 2.71828283), raised to the power specified 
by the expression in parentheses. In the example given above, the number 
returned is 20.08553G5. In some cases, EXP is accurate only to six significant 
digits. 



INT 



Format: INT (aexp) 
Examples: 100 I = INT(3.445) 

100 X = INT(- 14.66778) 



(3 would be stored in I) 
(-15 would be stored in X) 
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LOG 



RND 



Returns the greatest integer less than or equal to the value of the expression. 
This is true whether the expression evaluates to a positive or negative number. 
Thus, in our first example above, I is used to store the number 3. In the second 
example, X is used to store the number - 15 (the first whole number that is less 
than or equal to - 14.66778). This INT function should not be confused with the 
function used on calculators that simply truncates (cuts off) all decimal places. 

Format: LOG(aexp) 

Example: 100 L = LOG(67.89/2.57) 

Returns the natural logarithm of the number or expression in parentheses. 
LOG(0) should give an error and LOG(l) should be 0. 



Format: 
Example: 



RND(aexp) 
10 A = RND (0) 



Returns a hardware-generated random number between and 1, but never 
returns 1. The variable or expression in parentheses following RND is a dummy 
and has no effect on the numbers returned. However, the dummy variable must 
be used. Generally, the RND function is used in combination with other BASIC 
statements or functions to return a number for games, decision making, and the 
like. Here's a simple routine that returns a random number between and 999. 



19 X=RND<8> 

29 RX=INT<1000*:>O 

30 PRINT RX 



(0 is dummy variable) 



SGN 



SQR 



Format: 
Example: 



SGN(aexp) 

100 X = SGN(-199) 



(-1 would be returned) 



Returns a -1 if aexp evaluates to a negative number; a if aexp evaluates to 0, or a 
1 if aexp evaluates to a positive number. 

Format: SQR(aexp) 

Example: 100 PRINT SQR(100) (10 would be printed) 

Returns the square root of the aexp which must be positive. 



TRIGONOMETRIC 
FUNCTIONS 



ATN 



COS 



Format: ATN(aexp) 
Example: 100 X = ATN(65) 

Returns the arctangent of the variable or expression in parentheses. 

Format: COS(aexp) 

Example: 100 C = COS(X + Y + Z) 

Note: Presumes X, Y, Z previously defined! 

Returns the trigonometric cosine of the expression in parentheses. 



r^ 
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SIN 



DEG/RAD 



SPECIAL 

PURPOSE 

FUNCTIONS 



Format: 
Example: 



SIN(aexp) 

100 X = SIN(Y) 



Note: Presumes Y previously defined. 

Returns the trigonometric sine of the expression in parentheses. 



Format: DEG 

RAD 
Example: 100 DEG 

100 RAD 



These two statements allow the programmer to specify degrees or radians for 
trigonometric function computations. The computer defaults to radians unless 
DEG is specified. Once the DEG statement has been executed, RAD must be used 
to return to radians. 

See Appendix E for the additional trigonometric functions that can be derived. 



ADR 



FRE 



PEEK 



POKE 



Format: ADR(svar) 
Example: ADR(A$) 



Returns the decimal memory address of the string specified by the expression in 
parentheses. Knowing the address enables the programmer to pass the informa- 
tion to USR routines, etc. (See USR and Appendix D) 



Format: FRE(aexp) 
Examples: PRINT FRE (0) 

100 IF FRE (0)< 1000 THEN PRINT 



'MEMORY CRITICAL' 



This function returns the number of bytes of user RAM left. Its primary use is in 
Direct mode with a dummy variable (0) to inform the programmer how much 
memory space remains for completion of a program. Of course FRE can also be 
used within a BASIC program in Deferred mode. 



Format: 
Examples: 



PEEK(aexp) 

1000 IF PEEK (4000) = 255 THEN PRINT "255' 

100 PRINT "LEFT MARGIN IS"; PEEK (82) 



Returns the contents of a specified memory address location (aexp). The address 
specified must be an integer or an arithmetic expression that evaluates to an in- 
teger between and 65535 and represents the memory address in decimal nota- 
tion (not hexadecimal). The number returned will also be a decimal integer with 
a range from to 255. This function allows the user to examine either RAM or 
ROM locations. In the first example above, the PEEK is used to determine 
whether location 4000 (decimal) contains the number 255. In the second exam- 
ple, the PEEK function is used to examine the left margin. 



Format: 
Examples: 



POKE aexpl, aexp2 
POKE 82, 10 
100 POKE 82, 20 
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Although this is not a function, it is included in this section because it is closely 
associated with the PEEK function. This POKE command inserts data into the 
memory location or modifies data already stored there. In the above format, 
aexpl is the decimal address of the location to be poked and aexp2 is the data to 
be poked. Note that this number is a decimal number between and 255. POKE 
cannot be used to alter ROM locations. In gaining familiarity with this command 
it is advisable to look at the memory location with a PEEK and write down the 
contents of the location. Then, if the POKE doesn't work as anticipated, the 
original contents can be poked into the location. 

The above Direct mode example changes the left screen margin from its default 
position of 2 to a new position of 10. In other words, the new margin will be 8 
spaces to the right. To restore the margin to its normal default position, press 
— • 

USR Format: USR (aexpl [, aexp2][, aexp3...]) 

Example: 100 RESULT = USR (ADD1,A*2) 

This function returns the results of a machine-language subroutine. The first ex- 
pression, aexpl, must be an integer or arithmetic expression that evaluates to an 
integer that represents the decimal memory address of the machine language 
j routine to be performed. The input arguments aexp2, aexp3, etc., are optional. 

These should be arithmetic expressions within a decimal range of through 
65535. A non-integer value may be used; however, it will be rounded to the 
nearest integer. 

These values will be converted from BASIC'S Binary Coded Decimal (BCD) 
floating point number format to a two-byte binary number, then pushed onto 
the hardware stack, composed of a group of RAM memory locations under 
direct control of the 6502 microprocessor chip. Figure 6-1 illustrates the struc- 
ture of the hardware stack. 



N 
X 2 



(Number of arguments on the stack-may be 0) 
(High byte of argument X) 



(Low byte of argument X) 
Yi (High byte of argument Y) 

Y 2 (Low byte of argument Y) 

Z, (High byte of argument Z) 

Z 2 (Low byte of argument Z) 



Ri (Low byte of return address) 

R 2 (High byte of return address) 

Figure 6-1. Hardware Stack Definition 

Note: X is the argument following the address of the routine, Y is the 
second, Z is the third, etc. There are N pairs of bytes. 

See Section 11 for a description of the USR function in machine language pro- 
gramming. Appendix D defines the bytes in RAM available for machine 
language programming. 
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STRINGS 



This section describes strings and the functions associated with string handling. 
Each string must be dimensioned (see DIM statement, Section 8) and each string 
variable must end with a $. A string itself is a group of characters "strung" 
together. The individual characters may be letters, numbers, or symbols 
(including the Atari special keyboard symbols.) A substring is a part of a longer 
string and any substring is accessible in Atari BASIC if the string has been pro- 
perly dimensioned (see end of section). The characters in a string are indexed 
from 1 to the current string length, which is less than or equal to the dimen- 
sioned length of the string. 

The string functions described in this section are: 
ASC STR$ 

CHR$ VAL 

LEN 



ASC Format: ASC(sexp) 

Examples: 100A = ASC(A$) 



This function returns the ATASCII code number for the first character of the 
string expression (sexp). This function can be used in either Direct or Deferred 
mode. Figure 7-1 is a short program illustrating the ASC function. 

18 DIM H$<3> 

36 A=ASC(h$} 
48 PRINT A 

Figure 7-1. ASC Function Program 



When executed, this program prints a G9 which is the ATASCII code for the let- 
ter "E". Note that when the string itself is used, it must be enclosed in quotation 
marks. 



CHR$ Format: CHR$ (aexp) 

Examples: 100 PRINT CHR$ (65) 
100 A$ = CHR$ (65) 



This character string function returns the character, in string format, 
represented by the ATASCII code number(s) in parentheses. Only one character 
is returned. In the above examples, the letter A is returned. Using the ASC and 
CHR$ functions, the following program prints the upper case and lower case let- 
ters of the alphabet. 
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18 FOR 1=8 TO 25 

28 PRINT CHR$<HSC< H A"}+I>,CHR*<ASC< !! a"}+ 

I) 

Lir->.>T T 
,1 I 



38 NEXT 



Figure 7-2. ASC and CHR$ Program Example 
Note: There can be only one STR$ and only one CHR$ in a logical comparison. 



LEN Format: LEN (sexp) 

Example: 100 PRINT LEN(A$) 



This function returns the length in bytes of the designated string. This informa- 
tion may then be printed or used later in a program. The length of a string 
variable is simply the index for the character which is currently at the end of 
the string. Strings have a length of until characters have been stored in them. 
It is possible to store into the middle of the string by using subscripting. 
However, the beginning of the string will contain garbage unless something 
was stored (using STO) there previously. 

The following routine illustrates one use of the LEN function: 

18 can A$<:i8> 

28 A*=" ATARI" 
38 PRINT LEH(Af) 

Figure 7-3. LEN Function Example 

The result of running the above program would be 5. 



STR$ Format: STR$ (aexp) 

Example: A$ = STR$(65) 



This string from number function returns the string form of the number in 
parentheses. The above example would return the actual number 65, but it 
would be recognized by the computer as a string. 

Note: There can only be one STR$ and only one CHR$ in a logical comparison. 
For example, A = STR$(1) > STR$(2) is not valid and will not work correctly. 



VAL Format: VAL(sexp) 

Example: 100A = VAL(A$) 



This function returns a number of the same value as the number stored as a 
string. This is the opposite of a STR$ function. Using this function, the computer 
can perform arithmetic operations on strings as shown in the following exam- 
ple program: 

10 Din B$<5> 

28 B$=" 10008" 

30 B=SQR(UAL<B$>> 

40 PRINT "THE SQUARE ROOT OF ";B*;" IS " 

;B 

Figure 7-4. VAL Function Program 



^ 



f~\ 



Upon execution, the screen displays THE SQUARE ROOT OF B$ IS 100. 

It is not possible to use the VAL function with a string that does not start with a 
number, or that cannot be interpreted by the computer as a number. It can, 
however, intrepret floating point numbers; e.g.,VAL("lE9")would return the 
number 1,000,000,000. 

STRING Strings can be manipulated in a variety of ways. They can be split, concatenated, 

MANIPULATIONS rearran g ed > and sorted. The following paragraphs describe the different 

manipulations. 

String Concatenation 

Concatenation means putting two or more strings together to form one large 
string. Each string to be included in a larger string is called a substring. Each 
substring must be dimensioned (see DIM). In Atari BASIC, a substring can con- 
tain up to 99 characters (including spaces). After concatenation, the substrings 
can be stored in another string variable, printed, or used in later sections of the 
program. Figure 7-5 is a sample program demonstrating string concatenation. 
In this program, A$, B$, and C$ are concatenated and placed in A$. 

18 DIM A*< 1 80 ) > B$<. 1 08 ) , Cf( 1 86 > 

28 A*="STRINGS & SUBSTRINGS ARE DISCUSSE 

D " 

38 B$="IH 'ATARI BASIC— A SELF-TEACH IMG 

GUIDE'" 

48 C*=" — CHAPTER 9." 

58 A$<LEH<A$)+1>=B$ 

68 AI(LEH(Af >+l >=C$ 

78 PRINT m 

Figure 7-5. String Concatenation Example 

String Splitting 

The format of a subscript string variable is as follows: 

svarname(aexpl[ ,aexp2]) 

The svarname is used to indicate the unsubscripted string variable name (with 
$). aexpl indicates the starting location of the substring and aexp2 (if used) in- 
dicates the ending location of the substring. If no aexp2 is specified, then the end 
of the substring is the current end of the string. The starting location cannot be 
greater than the current length of the string. The two example programs in 
Figure 7-6 illustrate a split string with no end location indicated and a split 
string with an ending location indicated. 

18 Din S$<5> 18 DIM S$<28> 

20 S$="ABCD#" 28 S$=" ATARI 888 BASIC" 

38 PRINT S$<2> 38 PRINT S*<7,9> 

48 END 48 END 

Result is BCD. Result is 800. 

(without ending location) (with ending location) 

Figure 7-6. Split String Examples 
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String Comparisons and Sorts 

In string comparisons, the logical operators are used exactly the way they are 
with numbers. The second program in Appendix H is a simple example of bub- 
ble sort. 

In using logical operators, remember that each letter, number, and symbol is 
assigned an ATASCII code number. A few general rules apply to these codes: 

1. ATASCII codes for numbers are sized in order of the numbers' real 
values and are always lower than the codes for letters (see Appendix C). 

2. Upper case letters have lower numerical values than the lower case let- 
ters. To obtain the ATASCII code for a lower case letter if you know the 
upper case value, add 32 to the upper case code. 

Note: Atari BASIC'S memory management system moves strings around in 
memory to make room for new statements. This causes the string address to 
vary if a program is modified or Direct mode is used. 
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ARRAYS AND 
MATRICES 



An array is a one-dimensional list of numbers assigned to subscripted variables; 
e.g., A(0), A(l), A(2). Subscripts range from to the dimensioned value. Figure 
8-1 illustrates a 7-element array. 



A(0) 



A(l) 



A©) 



A(3) 



A(4) 



A(5) 



A(6) 



^ 



Figure 8-1. Example of an Array 

A matrix, in this context, is a two-dimensional table containing rows and col- 
umns. Rows run horizontally and columns run vertically. Matrix elements are 
stored by BASIC in row-major order. This means that all the elements of the 
first row are stored first, followed by all the elements of the second row, etc. 
Figure 8-2 illustrates a 7 x 4 matrix. 

Columns 



i 

o 



Figure 8-2. Example of a Matrix 

This section describes the two commands associated with arrays, matrices, and 
strings, and how to load both arrays and matrices. The commands in this sec- 
tion are: 



M(0,0) 


M(0,1) 


M(0,2) 


M(0,3) 


M(1,0) 


M(l,l) 


M(l,2) 


M(l,3) 


M(2,0) 


M(2,l) 


M(2,2) 


M(2,3) 


M(3,0) 


M(3,l) 


M(3,2) 


M(3,3) 


M(4,0) 


M(4,l) 


M(4,2) 


M(4,3) 


M(5,0) 


M(5,l) 


M(5,2) 


M(5,3) 


M(6,0) 


M(6,l) 


M(6,2) 


M(6,3) 



DIM (DI.) 



DIM 
CLR 

Format: 



DIM 



svar(aexp) 
mvar(aexp[ ,aexp]) 



in 



,svar(aexp) 
,mvar(aexp [ ,aexp ••• 



Examples: DIM A(100) 
DIM M(6,3) 
DIM B$(20) 



used with STRINGS 
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A DIM statement is used to reserve a certain number of locations in memory for 
a string, array, or matrix. A character in a string takes one byte in memory and 
a number in an array takes six bytes. The first example reserves 101 locations 
for an array designated A. The second example reserves 7 rows by 4 columns 
for a two-dimensional array (matrix) designated M. The third example reserves 
20 bytes designated B$. All strings, arrays, and matrices must be dimen- 
sioned. It is a good habit to put all DIM statements at the beginning of the pro- 
gram. Notice in Figure 8-1 that although the array is dimensioned as DIM A(6), 
there are actually 7 elements in the array because of the element. Although 
Figure 8-2 is dimensioned as DIM M(6,3), 28 locations are reserved. 

Note: The ATARI Personal Computer does not automatically initialize array or 
matrix variables to at the start of program execution. To initialize array or 
matrix elements to 0, use the following program steps: 



258 DIN h(!08) 
380 FOR E=8 TO 180 
310 A(3)=0 
320 NEXT E 



Arrays and matrices are "filled" with data by using FOR/NEXT statements, 
READ/DATA statements and INPUT commands. Figure 8-3 illustrates the 
"building" of part of an array using the FOR/NEXT loop and Figure 8-4 builds an 
array using the READ/DATA statements. 



10 dim Aciaa> 

20 X=18 

30 FOR E=l TO 98 

40 X=X+1 

50 A(E>=X 

60 NEXT E 

78 FOR E=l TO 98 

88 PRINT E,A<E> 

98 NEXT E 



Figure 8-3. Use of FOR/NEXT to Build An Array 



18 DIM A<3) 

28 FOR E=l TO 3 

30 READ X 

40 A<E>=X 

58 PRINT A(E>, 

60 NEXT E 

70 END 

100 DATA 33,45,12 

Figure 8-4. Use of READ/DATA to Build An Array 
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Figure 8-5 shows an example of building a 6x3 matrix. 



19 DIM MC6,3> 

28 FOR R0U=Q TO 6 

30 FOR C0L=1 TO 3 

40 M( RON , COL )=IHT( RHD< @ >t 1 080 ) 

50 NEKT COL = NEXT ROW 

60 FOR R0W=8 TO 6 

70 FOR C0L=1 TO 3 

80 PRINT ri(R0U>C0L) 

90 NEXT COL PRINT 'NEXT ROW 

Figure 8-5. Building A Matrix 

Note that the words ROW and COLUMN are not BASIC commands, statements, 
functions, or keywords. They are simply variable names used here to designate 
which loop function is first. The program could just as easily have been written 
with X and Y as the variable names. 



CLR Format: CLR 

Example: 200 CLR 



This command clears the memory of all previously dimensioned strings, arrays, 
and matrices so the memory and variable names can be used for other purposes. 
It also clears the values stored in undimensioned variables. If a matrix, string, or 
array is needed after a CLR command, it must be redimensioned with a DIM 
command. 
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9 

GRAPHICS MODES 
AND COMMANDS 



This section describes the Atari BASIC commands and the different graphics 
modes of the ATARI Personal Computer. Using these commands, it is possible to 
create graphics for game, graphics, and patterns. 

The commands to be described in this section are: 

GRAPHICS LOCATE PUT/GET 

COLOR PLOT SETCOLOR 

DRAWTO POSITION XIO 

The PUT/GET and XIO commands explained in this section are special applica- 
tions of the same commands described in Section 5. 



GRAPHICS (GR.) Format: GRAPHICS aexp 

Example: GRAPHICS 2 



This command is used to select one of the nine graphics modes. Table 9-1 sum- 
marizes the nine modes and the characteristics of each. The GRAPHICS com- 
mand automatically opens the screen, S:(the graphics window), as device #6. So 
when printing text in the text window, it is not necessary to specify the device 
code. The aexp must be positive, rounded to the nearest integer. Graphics mode 
is a full-screen display while modes 1 through 8 are split screen displays. To 
override the split-screen, add the characters + 16 to the mode number (aexp) in 
the GRAPHICS command. Adding 32 prevents the graphics command from 
clearing the screen. 

To return to graphics mode in Direct mode, press B33BSBSB or type GR.O 
and press l:UM:l!l 

TABLE 9.1 — TABLE OF MODES AND SCREEN FORMATS 

SCREEN FORMAT 









Vert. 


Vert. 


Number 




Gr. 


Mode 


Horiz. 


(Col) 


(Col) 


Of 


RAM 


Mode 


Type 


(Rows) 


Split 
Screen 


Full 
Screen 


Colors 


Required 
(Bytes) 





TEXT 


40 


- 


24 


2 


993 


1 


TEXT 


20 


20 


24 


5 


513 


2 


TEXT 


20 


10 


12 


5 


261 


3 


GRAPHICS 


40 


20 


24 


4 


273 


4 


GRAPHICS 


80 


40 


48 


2 


537 


5 


GRAPHICS 


80 


40 


48 


4 


1017 


6 


GRAPHICS 


160 


80 


96 


2 


2025 


7 


GRAPHICS 


160 


80 


96 


4 


3945 


8 


GRAPHICS 


320 


160 


192 


1/2 


7900 



The following paragraphs describe the nine graphics modes. 
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GRAPHICS 
MODEO 



GRAPHICS 
MODES 
1 AND 2 



This mode is the 1-color, 2-luminance (brightness) default mode for the ATARI 
Personal Computer. It contains a 24 by 40 character screen matrix. The default 
margin settings at 2 and 39 allow 38 characters per line. Margins may be chang- 
ed by poking LMARGN and RMARGN (82 and 83). See Appendix I. Some systems 
have different margin default settings. The color of the characters is determined 
by the background color. Only the luminance of the characters can be different. 
This full-screen display has a blue display area bordered in black (unless the 
border is specified to be another color). To display characters at a specified loca- 
tion, use one of the following two methods. 

Method 1. 

lineno POSITION aexpl, aexp2 Puts cursor at location 

lineno PRINT sexp specified by aexpl and aexpZ. 



Method 2 

lineno GR. 
lineno POKE 752,1 
lineno COLOR ASC(sexp) 

lineno PLOT aexpl,aexp2 

lineno GOTO lineno 



Specifies graphics mode. 

Suppresses cursor. 

Specifies character to be 

printed. 

Specifies where to print 

character. 

Start loop to prevent READY 

from being printed. (GOTO 

same lineno.) 



Press 
loop. 



to terminate 



GRAPHICS is also used as a clear screen command either in Direct mode or 
Deferred mode. It terminates any previously selected graphics mode and 
returns the screen to the default mode (GRAPHICS 0). 

As defined in Table 9-1, these two 5-color modes are Text modes. However, they 
are both split-screen (see Figure 9-1) modes. Characters printed in Graphics 
mode 1 are twice the width of those printed in Graphics 0, but are the same 
height. Characters printed in Graphics mode 2 are twice the width and height 
of those in Graphics mode 0. In the split-screen mode, a PRINT command is used 
to display characters in either the text window or the graphics window. To 
print characters in the graphics window, specify device #6 after the PRINT com- 
mand. 

Example: 100 GR. 1 

110 PRINT#6;"ATARI" 

The default colors depend on the type of character input. Table 9-2 defines the 
default color and color register used for each type. 



Table 9-2. Default Colors for Specific Input Types 



Character Type 

Upper case alphabetical 
Lower case alphabetical 
Inverse upper case alphabetical 
Inverse lower case alphabetical 
Numbers 
Inverse numbers 



Note: See SETCOLOR to change character colors. 



Color Register Default Color 





1 


Orange 
Light Green 


2 


Dark Blue 


3 


Red 



2 


Orange 
Dark Blue 
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Unless otherwise specified, all characters are displayed in upper case non- 
inverse form. To print lower case letters and graphics characters, use a POKE 
756,226. To return to upper case, use POKE 756,224. 

In graphics modes 1 and 2, there is no inverse video, but it is possible to get all 
the rest of the characters in four different colors (see end of section). 



(X = 0) 
(Y = 0) 



X-coordinatc 




Graphics Window 
(graphics or text) 



Text Window 
(4 lines) 

border (size 
depends on 
individual 
TV's overscan) 



Figure 9-1. Split-Screen Display For Graphics Modes 1 and 2 

The X and Y coordinates start at (upper left of screen). The maximum values 
are the numbers of rows and columns minus 1 (see Table 9-1). 

This split-screen configuration can be changed to a full screen display by adding 
the characters + 16 to the mode number. 

Example: GRAPHICS 1 + 1G 



GRAPHICS 

MODES 

3, 5, AND 7 



These three 4-color graphics modes are also split-screen displays in their default 
state, but may be changed to full screen by adding + 16 to the mode number. 
Modes 3, 5, and 7 are alike except that modes 5 and 7 use more points (pixels) in 
plotting, drawing, and positioning the cursor; the points are smaller, thereby 
giving a much higher resolution. 



GRAPHICS 
MODES 
4 AND 6 



GRAPHICS 
MODE 8 



These two 2-color graphics modes are split-screen displays and can display in 
only two colors while the other modes can display 4 and 5 colors. The advantage 
of a two-color mode is that it requires less RAM space (see Table 9-1). Therefore, 
it is used when only two colors are needed and RAM is getting crowded. These 
two modes also have a higher resolution which means smaller points than 
Graphics mode 3. 

This graphics mode gives the highest resolution of all the other modes. As it 
takes a lot of RAM to obtain this kind of resolution, it can only accomodate a 
maximum of one color and two different luminances. 
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COLOR (C.) 



Format: COLOR aexp 
Examples: 110 COLOR ASCC'A") 
110 COLOR 3 



The value of the expression in the COLOR statement determines the data to be 
stored in the display memory for all subsequent PLOT and DRAWTO com- 
mands until the next COLOR statement is executed. The value must be positive 
and is usually an integer from through 255. Non-integers are rounded to the 
nearest integer. The graphics display hardware interprets this data in different 
ways in the different graphics modes. In text modes through 2, the number 
can be from through 255 (8 bits) and determines the character to be displayed 
and its color. (The two most significant bits determine the color. This is why on- 
ly 64 different characters are available in these modes instead of the full 
256-character set.) 

Tables 9-6 and 9-7 at the end of this section illustrate the internal character set 
and the character/color assignment. Table 9-2 is a simplified table which allows 
easy generation of some of the colors. For example, COLOR ASCC'A"): PLOT 
5,5 will display an orange A character in graphics modes 1 or 2 at location 5,5. 

Graphics modes 3 through 8 are not text modes, so the data stored in the display 
RAM simply determines the color of each pixel. Two-color or two-luminance 
modes require either or 1 (1-bit) and four-color modes require 0, 1, 2, or 3. (The 
expression in the COLOR statement may have a value greater than 3, but only 
one or two bits will be used.) The actual color which is displayed depends on the 
value in the color register which corresponds to the data of 0, 1, 2, or 3 in the 
particular graphics mode being used. This may be determined by looking in 
Table 9-5, which gives the default colors and the corresponding register 
numbers. Colors may be changed by using SETCOLOR. 

Note that when BASIC is first powered up, the color data is 0, and when a 
GRAPHICS command (without +32) is executed, all of the pixels are set to 0. 
Therefore, nothing seems to happen to PLOT and DRAWTO in GRAPHICS 3 
through 7 when no COLOR statement has been executed. Correct by doing a 
COLOR 1 first. 



DRAWTO (DR.) 



Format: DRAWTO aexpl, aexp2 
Example: 100 DRAWTO 10, 8 



LOCATE (LOC.) 



This statement causes a line to be drawn from the last point displayed by a PLOT 
(see PLOT) to the location specified by aexpl and aexp2. The first expression 
represents the X coordinate and the second represents the Y-coordinate (see 
Figure 9-1). The color of the line is the same color as the point displayed by the 
PLOT. 

Format: LOCATE aexpl, aexp2, var 
Example: 150 LOCATE 12, 15, X 



This command positions the invisible graphics cursor at the specified location in 
the graphics window, retrieves the data at that pixel, and stores it in the 
specified arithmetic variable. This gives a number from to 255 for Graphics 
modes through 2; or 1 for the 2-color graphics modes; and 0, 1, 2, or 3 for the 
4-color modes. The two arithmetic expressions specify the X and Y coordinates 
of the point. LOCATE is equivalent to: 

POSITION aexpl, aexp2:GET #6,avar 
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Doing a PRINT after a LOCATE or GET from the screen may cause the data in 
the pixel which was examined to be modified. This problem is avoided by 
repositioning the cursor and putting the data that was read, back into the pixel 
before doing the PRINT. The following program illustrates the use of the 
LOCATE command. 



19 GRAPHICS 3+16 
28 COLOR 1 
30 SETCOLOR 2,18,8 
48 PLOT 18,15 



58 


DRhWTO 


15 


15 


68 


LOCATE 


12 


15, 


78 


PRINT :■ 


-, 





PLOT (PL.) 



Figure 9-2. Example Program Using LOCATE 

On execution, the program prints the data (1) determined by the COLOR state- 
ment which was stored in pixel 12, 15. 



Format: 
Example: 



PLOT aexpl, aexp2 
100 PLOT 5,5 



The PLOT command is used in graphics modes 3 through 8 to display a point in 
the graphics window. The aexpl specifies the X-coordinate and the aexp2 the 
Y-coordinate. The color of the plotted point is determined by the hue and 
luminance in the color register from the last COLOR statement executed. To 
change this color register, and the color of the plotted point, use SET- 
COLOR. Points that can be plotted on the screen are dependent on the graphics 
mode being used. The range of points begins at 1 and extends to one less than 
the total number of rows (X-coordinate) or columns (Y-coordinate) shown in 
Table 9-1. 



POSITION (POS.) Format: 

Example: 



PUT/GET 
(PU./GE.) 



POSITION aexpl, aexp2 
100 POSITION 8, 12 



The POSITION statement is used to place the invisible graphics window cursor 
at a specified location on the screen (usually precedes a PRINT statement). This 
statement can be used in all modes. Note that the cursor does not actually move 
until an I/O command which involves the screen is issued. 



Formats: 



Examples: 



PUT #aexp, aexp 
GET #aexp, avar 
100 PUT #6, ASCC'A") 
200 GET #1, X 



^ 



In graphics work, PUT is used to output data to the screen display. This state- 
ment works hand-in-hand with the POSITION statement. After a PUT (or GET), 
the cursor is moved to the next location on the screen. Doing a PUT to device #6 
causes the one-byte input (second aexp) to be displayed at the cursor position. 
The byte is either an ATASCII code byte for a particular character (modes 0-2) or 
the color data (modes 3-8). 

GET is used to input the code byte of the character displayed at the cursor posi- 
tion, into the specified arithmetic variable. The values used in PUT and GET cor- 
respond to the values in the COLOR statement. (PRINT and INPUT may also be 
used.) 
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Note: Doing a PRINT after a LOCATE or GET from the screen may cause the 
data in the pixel which was examined to be modified. To avoid this problem, 
reposition the cursor and put the data that was read, back into the pixel before 
doing the PRINT. 



SETCOLOR (SE.) Format: SETCOLOR aexpl, aexp2, aexp3 

Example: 100 SETCOLOR 0, 1, 4 



This statement is used to choose the particular hue and luminance to be stored 
in the specified color register. The parameters of the SETCOLOR statement are 
defined below: 

aexpl = Color register (0-4 depending on graphics mode) 

aexp2 = Color hue number (0-15. See Table 9-3) 

aexp3 = Color luminance (must be an even number between and 14; the 

higher the number, the brighter the display. 14 is almost pure 

white.) 



TABLE 9.3— THE ATARI HUE (SETCOLOR COMMAND) 
NUMBERS AND COLORS 

COLORS SETCOLOR (aexp2) NUMBERS 

GRAY 

LIGHT ORANGE (GOLD) 1 

ORANGE 2 

RED-ORANGE 3 

PINK 4 

PURPLE-BLUE G 

BLUE 7 

BLUE 8 

LIGHT BLUE 9 

TURQUOISE 10 

GREEN-BLUE 11 

GREEN 12 

YELLOW-GREEN 13 

ORANGE-GREEN 14 

LIGHT ORANGE 15 

Note: Colors will vary with type and adjustment of TV or monitor used. 

The ATARI display hardware contains five color registers, numbered 
from through 4. The Operating System (OS) has five RAM locations (COLOR0 
through COLOR4, see Appendix I - Memory Locations) where it keeps track of 
the current colors. The SETCOLOR statement is used to change the values in 
these RAM locations. (The OS transfers these values to the hardware registers 
every television frame.) The SETCOLOR statement requires a value from to 4 
to specify a color register. The COLOR statement uses different numbers 
because it specifies data which only indirectly corresponds to a color register. 
This can be confusing, so careful experimentation and study of the various 
tables in this section is advised. 

No SETCOLOR commands are needed if the default set of five colors is used. 
Although 128 different color-luminance combinations are possible, not more 
than five can be displayed at any one time. The purpose of the color registers 
and SETCOLOR statement is to specify these five colors. 
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'"Y 



TABLE 9.4— TABLE OF SETCOLOR "DEFAULT" COLORS* 



Set color 
(Color Register) 


1 
2 
3 
4 



Defaults To 
Color 

2 
12 
9 

4 




Luminance 



8 
10 
4 
G 




Actual Color 



ORANGE 

GREEN 

DARK BLUE 

PINK OR RED 

BLACK 



* "DEFAULT" occurs if not SETCOLOR statement is used. 

Note: Colors may vary depending upon the television monitor type, condition, 
and adjustment. 



A program illustrating Graphics mode 3 and the commands explained so far in 
this section is shown below: 



IS GRAPHICS 3 

26 SETCOLOR 0, 2, 8 : COLOR 1 

30 PLOT 17,1'ORAWTO 17/16 : DRAWTQ 9,18 

40 PLOT 19, 1QRAWT0 19,18 

50 PLOT 20,1-DRhWTO 28,18 

60 PLOT 22, 1 : DRAWT0 22,18 ; DRAWTQ 38,18 

70 POKE 75?. 1 



i JC J 



80 PRINT ■■ PRINT 
UTERS" 

90 bOTO 99 



ATAKl PERSONAL COMP 



The SETCOLOR and COLOR statements set the color of the points to be plotted 
(see Table 9.5). The SETCOLOR command loads color register with hue 2 
(orange) and a luminance of 8 ("normal"). The next 4 lines plot the points to be 
displayed. Line 90 suppresses the cursor and line 100 prints the string expres- 
sion ATARI PERSONAL COMPUTERS in the text window (6 spaces in). 



Note that the background color was never set because the default is the desired 
color (black). 

If the program is executed, it will print the Atari logo in the graphics window 
and the string expression in the text window as in Figure 9-3. 
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XIO (X.) 
SPECIAL FILL 
APPLICATION 



Format: XIO 18, #aexp, aexpl, aexp2, filespec 
Example: 100 XIO 18, #6, 0, 0, "S:" 



This special application of the XIO statement fills an area on the screen between 
plotted points and lines with a non-zero color value. Dummy variables (0) are 
used for aexpl and aexp2. 

The following steps illustrate the fill process: 

1. PLOT bottom right corner (point 1). 

2. DRAWTO upper right corner (point 2). This outlines the right edge of the 
area to be filled. 

3. DRAWTO upper left corner (point 3). 

4. POSITION cursor at lower left corner (point 4). 

5. POKE address 765 with the fill color data (1, 2, or 3). 

G. This method is used to fill each horizontal line from top to bottom of the spe- 
cified area. The fill starts at the left and proceeds across the line to the right 
until it reaches a pixel which contains non-zero data (will wraparound if 
necessary). This means that fill cannot be used to change an area which has 
been filled in with a non-zero value, as the fill will stop. The fill command 
will go into an infinite loop if a fill with zero (0) data is attempted on a line 
which has no non-zero pixels. M;nj;i nr EEE2ES33 can be used to stop the 
fill if this happens. 

The following program creates a shape and fills it with a data (color) of 3. Note 
that the XIO command draws in the lines of the left and bottom of the figure. 



16 GRAPHICS 5+16 
28 COLOR 3 
30 PLOT 78,45 
40 DRAWTO 50, 18 
50 DRAWTO 30, 18 
60 POSITION 10,45 
70 POKE 765,3 
88 KIO 18, #6,8,0, "S = 
98 GOTO 38 



Figure 9-4. Example "FILL" Program 



Assigning Colors To Characters In Text Modes 1 and 2 

This procedure describes the method of assigning colors to the Atari character 
set. First, look up the character number in Table 9-6. Then, see Table 9-7 to get 
the conversion of that number required to assign a color register to it. 

Example: Assign SETCOLOR to lower case "r" in mode 2 
whose color is determined by register 0. 

1. In Table 9-6, find the column and number for "r" (114-column 4). 

2. Using Table 9-7, locate column 4. Conversion is the character number minus 
32 (114 - 32 = 82). 
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Table 9.7— CHARACTER/COLOR ASSIGNMENT 




Conversion 1 


Conversion 2 


Conversion 3 


Conversion 4 


MODEO 


2 SETCOLOR 2 


# + 32 


# + 32 


#-32 


NONE 




POKE 756,224 POKE 756,226 


MODE 1 

OR 
MODE 2 


SETCOLOR 


-«32 . 


# + 32 


#-32 


#-32 


SETCOLOR 1 


NONE 


# + 64 


#-64 


NONE 


SETCOLOR 2 


#+160 


#+160 


# + 96 


# + 96 


SETCOLOR 3 


#+128 


#+192 


#+64 


#+128 



2. Luminance controlled by SETCOLOR 1, 0, LUM. 



3. POKE the Character Base Address (CHBAS) with 226 to specify lower case let- 
ters or special graphics characters; e.g., 

POKE 756,226 

or 
CHBAS = 756 
POKE CHBAS, 226 



To return to upper case letters, numbers, and punctuation marks, POKE CHBAS 
with 224. 

4. A PRINT statement using the converted number (82) assigns the lower case 
"r" to SETCOLOR in mode 2 (see Table 9-5). 

Graphic Control Characters 

These characters are produced when the GE3 key is pressed with the 
alphabetic keys shown on back cover. These characters can be used to draw 
design, pictures, etc., in mode and in modes 1 and 2 if CHBAS is changed. 
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10 

SOUNDS AND GAME 
CONTROLLERS 



This section describes the statement used to generate musical notes and sounds 
through the audio system of the television monitor. Up to four different sounds 
can be "played" simultaneously creating harmony. This SOUND statement can 
also be used to simulate explosions, whistles, and other interesting sound ef- 
fects. The other commands described in this section deal with the functions 
used to manipulate the keyboard, joystick, and paddle controllers. These func- 
tions allow these controllers to be plugged in and used in BASIC programs for 
games, etc. 

The command and functions covered in this section are: 

SOUND PADDLE STICK 

PTRIG STRIG 



SOUND (SO.) Format: SOUND aexpl, aexp2, aexp3, aexp4 

Example: 100 SOUND 2, 204, 10, 12 



The SOUND statement causes the specified note to begin playing as soon as the 
statement is executed. The note will continue playing until the program en- 
counters another SOUND statement with the same aexpl or an END statement. 
This command can be used in either Direct or Deferred modes. 



The SOUND parameters are described as follows: 

aexpl = Voice. Can be 0-3, but each voice requires a separate SOUND state- 
ment. 

aexp2 = Pitch. Can be any number between 0-255. The larger the number, 
the lower the pitch. Table 10-1 defines the pitch numbers for the 
various musical notes ranging from two octaves above middle C to 
one octave below middle C. 

aexp3 = Distortion. Can be even numbers between 0-14. Used in creating 
sound effects. A 10 is used to created a "pure" tone whereas a 12 
gives an interesting buzzer sound. A buzzing sound (like engines at 
a race track) can be produced using two separate SOUND commands 
with the distortion value (aexp3) alternating between and 1. A 
value of 1 is used to force output to the speaker using the specified 
volume (see aexp4). The rest of the numbers are used for other 
special effects, noise generation, and experimental use. 

aexp4 = Volume control. Can be between 1 and 15. Using a 1 creates a sound 
barely audible whereas a 15 is loud. A value of 8 is considered nor- 
mal. If more than 1 sound statement is being used, the total volume 
should not exceed 32. This will create an unpleasant "clipped" tone. 
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Using the note values in Table 10-1, the following example demonstrates how to 

write a program that will "play" the C scale. 

TABLE 10.1. TABLE OF PITCH VALUES FOR THE MUSICAL 

NOTES 

HIGH C 29 

NOTES B 31 

A#orBb 33 

A 35 

Gff or A\> 37 

G 40 

F# or G\> 42 

F 45 

E 47 

D# or E 50 

D 53 

OorDb 57 

C 60 

B 64 

A# or B 68 

A 72 

G# or Ab 76 

G 81 

F# or G!> 85 

F 91 

E 96 

D# or Eb 102 

D 108 

C# or Dt> 114 

MIDDLE C C 121 

B 128 

A# or B\> 136 

A 144 

G# or Ab 153 

G 162 

F# Gb 173 

F 182 

LOW NOTES D 193 

Dff or lb 204 

, D 217 ; 

O or Db 230 

C 243 

10 READ H 

20 IF A=256 THEN EHD 

30 SOUND 0,A, 10, 13 

40 FOR W=l TO 400 = NEXT U 

50 PRINT R 

60 GOTO 10 

70 ENO 

80 DATA 29, 31, 35, 48, 45, 47,53, £0,64, 72,81 

,91,96,108,121 

90 DATA 128,144,162,132,193,217,243,256 

Figure 10-1. Musical Scale Program 

Note that the DATA statement in line 80 ends with a 256, which is outside of the 
designated range. The 256 is used as an end-of-data marker. 
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GAME 

CONTROLLER 

FUNCTIONS 



Figure 10-2 is an illustration of the three controllers used with the Atari Per- 
sonal Computers. The controllers can be attached directly to the Atari Per- 
sonal Computer or to external mechanical devices so that outside events can be 
fed directly to the computer for processing and control purposes. 





PADDLE 



PTRIG 



Figure 10-2. Game Controllers 



Format: 
Example: 



PADDLE(aexp) 
PRINT PADDLE(3) 



This function returns the status of a particular numbered controller. The paddle 
controllers are numbered 0-7 from left to right. This function can be used with 
other functions or commands to "cause" further actions like sound, graphics 
controls, etc. For example, the statement IF PADDLE(3) = 14 THEN PRINT 
"PADDLE ACTIVE." Note that the PADDLE function returns a number bet- 
ween 1 and 228, with the number increasing in size as the knob on the con- 
troller is rotated counterclockwise (turned to the left). 



Format: 
Example: 



PTRIG(aexp) 
100 IF PTRIG(4) > 



THEN PRINT "MISSILES FIRED!' 



The PTRIG function returns a status of if the trigger button of the designated 
controller is pressed. Otherwise, it returns a value of 1. The aexp must be a 
number between and 7 as it designates the controller. 



STICK 



Format: 
Example: 



STICK(aexp) 

100 PRINT STICK(3) 



This function works exactly the same way as the PADDLE command, but can be 
used with the joystick controller. The joystick controllers are numbered from 
0-3 from left to right. 

Controller 1 = STICK(O) 

Controller 2 = STICK(l) 

Controller 3 = STICK(2) 

Controller 4 = STICK(3) 

Figure 10-3 shows the numbers that will be returned when the joystick con- 
troller is moved in any direction. 
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11-* 




► 7 



STRIG 



Figure 10-3. Joystick Controller Movement 

Format: STRIG(aexp) 

Example: 100 IF STRIG(3) = THEN PRINT "FIRE TORPEDO" 

The STRIG function works the same way as the PTRIG function. It can be used 
with both the joystick and keyboard controllers. 
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11 

ADVANCED PROGRAMMING 

TECHNIQUES 



This section includes hints on increasing programming efficiency, conserving 
memory, and combining machine language programs with Atari BASIC pro- 
grams. This section does not include an instruction set for the 6502 micro- 
processor chip nor does it give instructions on programming in machine 
language. An additional purchase of the Atari Assembler Editor cartridge* and 
a careful study of Atari's Assembler Editor Manual are strongly recommended. 



MEMORY 

CONSERVATION These hints give ways of conserving memory. Some of these methods make pro- 
grams less readable and harder to modify, but there are cases where this is 
necessary due to memory limitations. 



In many small computers, eliminating blank spaces between words and 
characters as they are typed into the keyboard will save memory. This is not 
true of the ATARI Personal Computer System, which removes extra spaces. 
Statements are always displayed the same regardless of how many spaces 
were used on program entry. Spaces should be used (just as in typing on a 
conventional typewriter) between successive keywords and between 
keywords and variable names. Here is an example: 



10 IF A = 5 THEN PRINT A 



Note the space between IF and A and between THEN and PRINT. In most 
cases, a statement will be interpreted correctly by the computer even if all 
spaces are left out, but this is not always true. Use conventional spacing. 



2. Each new line number represents the beginning of what is called a new 
"logical line". Each logical line takes 6 bytes of "overhead", whether it is 
used to full capacity or not. Adding an additional BASIC statement by using a 
colon (:) to separate each pair of statements on the same line takes only 3 
bytes. 



'Available late 1980. 
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If you need to save memory, avoid programs like this: 

18 X=Y+1 
20 Y=Y+1 
30 Z=X+Y 
46 PRINT Z 
50 GOTO 50 



and consolidate lines like this: 

10 K=X+1=Y=Y+1:Z=X+Y:PRINT Z=G0T0 10 

This consolidation saves 12 bytes. 



Variables and constants should be "managed" for savings, too. Each time a 
constant (4,5,16,3.14159, etc.) is used, it takes 7 bytes. Defining a new 
variable requires 8 bytes plus the length of the variable name (in characters). 
But each time it is used after being defined, it takes only 1 byte, regardless of 
its length. Thus, if a constant (such as 3.14159) is used more than once or 
twice in a program, it should be defined as a variable, and the variable name 
used throughout the program. For example: 



10 PI=3. 14153 

20 PRINT "AREA OF A CIRCLE IS THE RADIUS 
SQUARED TIMES ";PI 



Literal strings require 2 bytes overhead and 1 byte for each character 
(including all spaces) in the string. 



String variables take 9 bytes each plus the length of the variable name 
(including spaces) plus the space eaten up by the DIM statement plus the size 
of the string itself (1 byte per character, including spaces) when it is defined. 
Obviously, the use of string variables is very costly in terms of RAM. 



Definition of a new matrix requires 15 bytes plus the length of the matrix 
variable name plus the space needed for the DIM statement plus G times the 
size of the matrix (product of the number of rows and the number of col- 
umns). Thus, a 25 row by 4 column matrix would require 15 + approxi- 
mately 3 (for variable name) + approximately 10 (for the DIM statement) + 6 
times 100 (the matrix size), or about 630 bytes. 
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7. Each character after REM takes one byte of memory. Remarks are helpful to 
people trying to understand a program, but sometimes it is necessary to 
remove remark statements to save memory. 



8. Subroutines can save memory because one subroutine and several short calls 
take less memory than duplicating the code several times. On the other 
hand, a subroutine that is only called once takes extra bytes for the GOSUB 
and RETURN statements. 



Parentheses take one byte each. Extra parentheses are a good idea in some 
cases if they make an expression more understandable to the programmer. 
However, removing unnecessary parentheses and relying on operator 
precedence will same a few bytes. 



PROGRAMMING Machine language is written entirely in binary code. The ATARI Personal Com- 

IN MACHINE puter contains a 6502 microprocessor and it is possible to call 6502 machine code 

ATVTr'TT APP subroutines from BASIC using the USR function. Short routines may then be 

L/AI\ljU-A.Li.b entered into a program by hand assembly (if necessary). 



1 



Before it returns to BASIC, the assembly language routine must do a pull ac- 
cumulator (PLA) instruction to remove the number (N) of input arguments off 
the stack. If this number is not 0, then all of the input arguments must be pop- 
ped off the stack also using PLA. (See Figure 6-1). 



The subroutine should end by placing the low byte of its result in location 212 
(decimal), and then return to BASIC using an RTS (Return from Subroutine) in- 
struction. The BASIC interpreter will convert the 2-byte binary number stored 
in locations 212 and 213 into an integer between and 65535 in floating-point 
format to obtain the value returned by the USR function. 



The ADR function may be used to pass data that is stored in arrays or strings to a 
subroutine in machine language. Use the ADR function to get the address of the 
array or string, and then use this address as one of the USR input arguments. 



The following program, Hexcode Loader, provides the means of entering hexa- 
decimal codes, converting each hexadecimal number to decimal, and storing the 
decimal number into an array. The array is then executed as an assembly 
language subroutine. (An array is used to allocate space in memory for the 
routine.) 



n 
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1. To use this program, first enter it. After entering it, save this program on 
disk or cassette for future use. 



18 GRAPHICS 0= PRINT "HEXCODE LOADER PROG 
RAM": PRINT 

20 RBI STORES DECIMAL EQUIVALENTS IN ARR- 
AY A, OUTPUTS IN PRINTED 'DATA STATEMENT 
S' AT 

21 REM LINE NUMBER 1309. 

30 RBI USER THEN PLACES CURSOR ON PRINTE 
D OUTPUT LINE, HITS "RETURN", AND ENTERS 

31 REM REST OF BASIC PROGRAM INCLUDING U 
SR STATEMENT. 

40 DIM A<58),HEX$<5) 

50 REM INPUT, CONVERSION, STORAGE OF DATA. 

60 N=0= PRINT "ENTER 1 HEX CODE. IF LAST 
ONE IS IN, ENTER 'DONE'."; 
70 INPUT HEX* 

80 IF HEX*="D0NE" THEN N=999=G0T0 130 
90 FOR 1=1 TO LBKHEX*) 
100 IF HEX*a,I)<="9" THEN N=NS16+UAL<HE 
XK 1,1)): GOTO 120 

1 10 N=N:*16+ASC< HEXK 1,1) )-ASC< "A" )+10 
120 NEXT I 
130 PRINT N:C=C+1 
148 A<C)=N 

150 IF N<>999 THEN GOTO 60 
190 REM PRINT OUT DATA LINE AT 1500 
200 GRAPHICS 0: PRINT "1500 DATA"; 
210 C=0 
220 C=C+1 

230 IF A(C)=999 THEN PRINT "999"= STOP 
240 PRINT A<C);","; 
250 A(C)=0 
260 GOTO 220 

300 PRINT "PUT CORRECT NUMBER OF HE* BYT 
ES IN LINE 1000."= STOP :REM TRAP LINE 

999 REM U EXECUTION MODULE U 

1000 CLR =BYTES=0 

1018 TRAP 300-DIM Eftl >, EC INK BYTES/6 )+l 

) 

1030 FOR 1=1 TO BYTES 

1940 READ A: IF A>255 THEN GOTO 1068 

1058 POKE A0R<E$)+I,A 

1060 NEXT I 

1070 REM BASIC PART OF USER'S PROGRAM FO 

LLOWS 



Figure 11-1. Hexcode Loader Input Program 
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r 



2. Now add the BASIC language part of your program starting at line 1080 in- 
cluding the USR function that calls the machine language subroutine. (See 
example below.) 

3. Count the total number of hex codes to be entered and enter this number on 
line 1000 when requested. If another number is already entered, simply 
replace it. 

4. Run the program and enter the hexadecimal codes of the machine level 
subroutine pressing EgJEJ after each entry. After the last entry, type 
DONE and press l:UJH:l!l . 



Now the DATA line (1500) displays on the screen. It will not be ent ered in to 
the program until the cursor is moved to the DATA line and QB333 is 
pressed. 



6. Add a program line 5 GOTO 1000 to bypass the hexcode loader (or delete the 
hexcode loader through line 2G0). Now save the completed program by 
using CSAVE or SAVE. It is important to do this before executing the part of 
the program containing the USR call. A mistake in a machine language 
routine may cause the system to crash. If the system does hang up, press 
EflggflggH • If tne system doesn't respond, turn power off and on again, 
reload the program, and correct it. 



Note: This method only works with relocatable machine language routines. 



The following two sample programs can each be entered into the Hexcode 
Loader program. The first program prints NOTHING IS MOVING while the 
machine program changes the colors. The second sample program displays a 
BASIC graphics design, then changes colors. 



1080 GRAPHICS 1+16 

1890 FOR 1=1 TO 6 

1100 PRINT #6; "nothins is (twine! " 

1110 PRINT #6; "NOTHING IS MOUIHG!" 

1120 PRINT #6.; "nothins is moving" 

1130 PRINT #6; "NOTHING IS MOVING*" 

1140 NEXT I 

1150 GMJSRCAORCED+n 

1160 FOR 1=1 TO 25= NEXT ^GOTO 1150 



After entering this program, check that line 1000 reads: 

1000 CLR:BYTES = 21 

Type RUN QQQQ . 
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Now enter the hexadecimal codes as shown column by column. 

68 2 

A2 E8 

EO 

AC 3 

C4 90 

2 F5 

BD 8C 

C5 C7 

2 2 

9D GO 
C4 BYTES = 21 

When completed, type DONE and press QgQ| . Now place the cursor after the 

last entry (999) on the DATA line and nress ffTSflTfll . 

Now run the program by typing GOTO 1000 and pressing l:l=WH:l?l . or if line 5 

has been added, tvpe RUN l:ldll:l?l . Press 1:1:1 JVM to stop program and delete line 
5. 

The second program, which follows, should be entered in place of the 

NOTHING IS MOVING program. Be sure to check the BYTES = count in 

line 1000. Follow steps 2 through 6. 

1089 GRAPHICS 7+16 

1890 SETCOLGR 9,9,4 

1109 SETCOLOR 1,9,8 

1110 SETCOLOR 2,9,4 
1120 CR=1 

1130 FOR X=8 TO 159 

1140 COLOR INT(CR) 

1150 PLOT 38,0 

1160 DRAWTO X,95 

1170 CR=CR+0.125 

1180 IF CR=4 THEN CR=1 

1190 NEXT X 

1280 X=USR<hGR<E*>+1> 

1210 FOR 1=1 TO 15 = NEXT I 

1220 GOTO 1200 

Type RUN l:UH:1.'l 

Enter the hexadecimal codes for this program column by column. 

68 2 

A2 E8 

EO 

AC 2 

C4 90 

2 F5 

BD 8C 

C5 C6 

2 2 

9D 60 
C4 BYTES = 21 
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When completed, type DONE and press QQQ. Now place the cursor after the 

last entry (999) on the DATA line and press 1:UW;I!I . 

Now run the program by typing GOTO 1000 and pressing QBQQ,or add line 5 

GOTO 1000 and type RUN l:UJI:l!l . Press EfflS to stop program and delete line 
5. 

Figure 11-2 illustrates an assembler subroutine used to rotate colors which 
might prove useful. It is included here for the information of the user. 



Assembler Subroutine to Rotate Colors.. 



Address 


Object 
Code 


Line 
No. 


Label 


Mnemonic 


Data 








0100 








Routine to rotate COLOR data 






0110 
0120 








From one register to another. 
4 colors are rotated. 






0130 










02C4 




0140 
0150 








Operating system address 
COLOR = $02C4 


02C5 




0160 








COLOR 1 = $02C5 


02C6 




0170 








COLOR 2 = $02C6 


02C7 




0175 








COLOR 3 = $02C7 






0180 
0190 




* __ 


$6000 


Machine program starting address 


6000 
6001 


68 
A200 


0200 
0210 




PLA 
LDX 


#0 


Pop stack (See Chapter 4) 
Zero the X register 


6003 


ACC402 


0220 




LDY 


COLOR0 


Save COLOR 


6006 


BDC502 


0230 


LOOP 


LDA 


COLORl,X 




6009 
600C 


9DC402 
E8 


0240 
0250 




STA 
INX 


COLOR0,X 


Increment the X register (add one) 


600D 


E002 


0260 




CPX 


#3 


Compare contents of X register 
with 2 


600F 


90F5 


0270 




BCC 


LOOP 


Loop if X register contents are 
less than 2 


6011 


8CC602 


0280 




STY 


COLOR3 


Save COLOR in COLOR 3 


6014 


60 


0290 




RTS 




Return from machine level sub- 
routine 


Assembler 
Prints This 


This Portion is Source Information Programmer Enters 
Using Atari Assembler Cartridge 



# Indicates data (source) 

* Routine is relocatable 

$ Indicates a hexadecimal number 



Figure 11-2. Assembler Subroutine To Rotate Colors 



^ 
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APPENDIX A 



ALPHABETICAL DIRECTORY 
OF BASIC RESERVED WORDS 



1 



Note: The period is mandatory after all abbreviated keywords. 
ABBREVIATION: 



RESERVED 
WORD: 



ABS 

ADR 
AND 

ASC 

ATN 

BYE 

CLOAD 
CHR$ 

CLOG 

CLOSE 

CLR 

COLOR 

COM 
CONT 

COS 
CSAVE 



CLOA. 



CL. 



CON. 



BRIEF SUMMARY 
OF BASIC STATEMENT 



Function returns absolute value (unsigned) of the 
variable or expression. 

Function returns memory address of a string. 

Logical operator: Expression is true only if both subex- 
pressions joined by AND are true. 

String function returns the numeric value of a single 
string character. 

Function returns the arctangent of a number or expres- 
sion in radians or degrees. 

Exit from BASIC and return to the resident operating 
system or console processor. 

Loads data from Program Recorder into RAM. 

String function returns a single string byte equivalent 
to a numeric value between and 255 in ATASCII code. 

Function returns the base 10 logarithm of an expres- 
sion. 

I/O statement used to close a file at the conclusion of I/O 
operations. 

The opposite of DIM: Undimensions all strings; 
matrices. 

Chooses color register to be used in color graphics 
work. 

Same as DIM. 

Continue. Causes a program t o restar t execution on the 
next line following use of the 1STOM key or encounter- 
ing a STOP. 

Function returns the cosine of the variable or expres- 
sion (degrees or radians). 

Outputs data from RAM to the Program Recorder for 
tape storage. 
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RESERVED 
WORD: 

DATA 



DEG 

DIM 

DOS 

DRAWTO 

END 

ENTER 
EXP 
FOR 

FRE 

GET 

GOSUB 

GOTO 
GRAPHICS 

IF 

INPUT 

INT 

LEN 



ABBREVIATION: 
D. 

DE. 

DI. 

DO. 



DR. 



E. 



F. 



GE. 

GOS. 

G. 
GR. 



BRIEF SUMMARY 
OF BASIC STATEMENT 



Part of READ/DATA combination. Used to identify the 
succeeding items (which must be separated by commas) 
as individual data items. 

Statement DEG tells computer to perform 
trigonometric functions in degrees instead of radians. 
(Default in radians.) 

Reserves the specified amount of memory for matrix, 
array, or string. All string variables, arrays, matrices 
must be dimensioned with a DIM statement. 

Reserved word for disk operators. Causes the menu to 
be displayed. (See DOS Manual.) 

Draws a straight line between a plotted point and 
specified point. 

Stops program execution; closes files; turns off sounds. 
Program may be restarted using CONT. (Note: END 
may be used more than once in a program.) 

I/O command used to store data or programs in un- 
tokenized (source) form. 

Function returns e (2.7182818) raised to the specified 
power. 

Used with NEXT to establish FOR/NEXT loops. In- 
troduces the range that the loop variable will operate in 
during the execution of loop. 

Function returns the amount of remaining user 
memory (in bytes). 

Used mostly with disk operations to input a single byte 
of data. 

Branch to a subroutine beginning at the specified line 
number. 

Unconditional branch to a specified line number. 

Specifies which of the eight graphics modes is to be 
used. GR.O may be used to clear screen. 

Used to cause conditional branching or to execute 
another statement on the same line (only if the first ex- 
pression is true). 

Causes computer to ask for input from keyboard. Ex- 
ecution continues only when IJaJM.'l key is pressed after 
inputting data. 

Function returns the next lowest whole integer below 
the specified value. Rounding is always downward, 
even when number is negative. 

String function returns the length of the specified str- 
ing in bytes or characters (1 byte contains 1 character). 
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RESERVED 
WORD: 

LET 

LIST 

LOAD 
LOCATE 

LOG 

LPRINT 

NEW 

NEXT 

NOT 

NOTE 
ON 

OPEN 
OR 

PADDLE 
PEEK 

PLOT 

POINT 
POKE 

POP 

POSITION 
PRINT 



ABBREVIATION: 

LE. 

L. 

LO. 

LOC. 

LP. 

N. 



NO. 



O. 



PL. 

P. 
POK. 



POS. 

PR. or ? 



BRIEF SUMMARY 
OF BASIC STATEMENT 

Assigns a value to a specific variable name. LET is op- 
tional in Atari BASIC, and may be simply omitted. 

Display or otherwise output the program list. 

Input from disk, etc. into the computer. 

Graphics: Stores, in a specified variable, the value that 
controls a specified graphics point. 

Function returns the natural logarithm of a number. 

Command to line printer to print the specified message. 

Erases all contents of user RAM. 

Causes a FOR/NEXT loop to terminate or continue 
depending on the particular variables or expressions. 
All loops are executed at least once. 

A "1" is returned only if the expression is NOT true. If 
it is true, a "0" is returned. 

See DOS/FMS Manual.. .used only in disk operations. 

Used with GOTO or GOSUB for branching purposes. 
Multiple branches to different line numbers are possible 
depending on the value of the ON variable or expres- 
sion. 

Opens the specified file for input of output operations. 

Logical operator used between two expressions. If 
either one is true, a "1" is evaluated. A "0' results only 
if both are false. 

Function returns position of the paddle game controller. 

Function returns decimal form of contents of specified 
memory location (RAM or ROM). 

Causes a single point to be plotted at the X,Y location 
specified. 

Used with disk operations only. 

Insert the specified byte into the specified memory loca- 
tion. May be used only with RAM. Don't try to POKE 
ROM or you'll get an error. 

Removes the loop variable from the GOSUB stack. Used 
when departure from the loop is made in other than 
normal manner. 

Sets the cursor to the specified screen position. 

I/O command causes output from the computer to the 
specified output device. 
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RESERVED 

WORD: ABBREVIATION: 



BRIEF SUMMARY 
OF BASIC STATEMENT 



PTRIG 



PUT 



RAD 



PU. 



Function returns status of the trigger button on game 
controllers. 

Causes output of a single byte of data from the computer 
to the specified device. 

Specifies that information is in radians rather than 
degrees when using the trigonometric functions. 
Default is to RAD. (See DEC) 



READ 



REM 



REA. 



R. or . 



Read the next items in the DATA list and assign to 
specified variables. 

Remarks. This statement does nothing, but comments 
may be printed within the program list for future 
reference by the programmer. Statements on a line that 
starts 'with REM are not executed. 



RESTORE 
RETURN 

RND 

RUN 

SAVE 

SETCOLOR 

SGN 

SIN 

SOUND 

SftR 

STATUS 

STEP 

STICK 
STRIG 

STOP 



RES. 
RET. 



RU. 



S. 



SE. 



SO. 



ST. 



STO. 



Allows DATA to be read more than once. 

RETURN from subroutine to the statement immediate- 
ly following the one in which GOSUB appeared. 

Function returns a random number between and 1, 
but never 1. 

Execute the program. Sets normal variables to 0, un- 
dims arrays and string. 

I/O statement causes data or program to be recorded on 
disk under filespec provided with SAVE. 

Store hue and luminance color data in a particular color 
register. 

Function returns + 1 if value is positive, if zero, - 1 if 
negative. 

Function returns trigonometric sine of given value 
(DEG or RAD). 

Controls register, sound pitch, distortion, and volume of 
a tone or note. 

Function returns the square root of the specified value. 

Calls status routine for specified device. 

Used with FOR/NEXT. Determines quality to be 
skipped between each pair of loop variable values. 

Function returns position of stick game controller. 

Function returns 1 if stick trigger button not pressed, 
if pressed. 

Causes execution to stop, but does not close files or turn 
off sounds. 
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RESERVED 

WORD: ABBREVIATION: 



BRIEF SUMMARY 
OF BASIC STATEMENT 



STR$ 



THEN 



TO 



TRAP 



USR 



VAL 



XIO 



Function returns a character string equal to numeric 
value given. For example: STR$(65) returns 65 as a 
string. 

Used with IF: If expression is true, the THEN 
statements are executed. If the expression is false, con- 
trol passes to next line. 

Used with FOR as in "FOR X = 1 TO 10". Separates the 
loop range expressions. 

Takes control of program in case of an INPUT error 
and directs execution to a specified line number. 

Function returns results of a machine-language 
subroutine. 

Function returns the equivalent numeric value of a 
string. 

General I/O statement used with disk operations (see 
DOS/FMS Manual) and in graphics work (Fill). 



n 
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Notes 



APPENDIX B 



ERROR 

MESSAGES 



ERROR 
CODE NO. ERROR CODE MESSAGE 

2 Memory insufficient to store the statement or the new variable name or to DIM a 
new string variable. 

3 Value Error: A value expected to be a positive integer is negative, a value ex- 
pected to be within a specific range is not. 

4 Too Many Variables: A maximum of 128 different variable names is allowed. 
(See Variable Name Limit.) 

5 String Length Error: Attempted to store beyond the DIMensioned string length. 

6 Out of Data Error: READ statement requires more data items than supplied by 
DATA statement(s). 

7 Number greater than 32767: Value is not a positive integer or is greater than 
327G7. 

8 Input Statement Error: Attempted to INPUT a non-numeric value into a 
numeric variable. 

9 Array or String DIM Error: DIM size is greater than 32767 or an array/martix 
reference is out of the range of the dimensioned size, or the array /matrix or string 
has been already DIMensioned, or a reference has been made to an undimensioned 
array or string. 

10 Argument Stack Overflow: There are too many GOSUBs or too large an expres- 
sion. 

11 Floating Point Overflow/Underflow Error: Attempted to divide by zero or 
refer to a number larger than 1 x 10 98 or smaller than 1 x 10 - ". 

12 Line Not Found: A GOSUB, GOTO, or THEN referenced a non-existent line 
number. 

13 No Matching FOR Statement: A NEXT was encountered without a previous 
FOR, or nested FOR/NEXT statements do not match properly. (Error is reported at 
the NEXT statement, not at FOR). 

14 Line Too Long Error: The statement is too complex or too long for BASIC to 
handle. 

15 GOSUB or FOR Line Deleted: A NEXT or RETURN statement was encountered 
and the corresponding FOR or GOSUB has been deleted since the last RUN. 
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ERROR 
CODE NO. 

16 
17 



18 



ERROR CODE MESSAGE 



RETURN Error: A RETURN was encountered without a matching GOSUB. 

Garbage Error: Execution of "garbage" (bad RAM bits) was attempted. This error 
code may indicate a hardware problem, but may also be the result of faulty use of 
POKE. Try typing NEW or powering down, then re-enter the program without 
any POKE commands. 

Invalid String Character: String does not start with a valid character, or string 
in VAL statement is not a numeric string. 



Note: 



The following are INPUT/OUTPUT errors that result during the use of disk 
drives, printers, or other accessory devices. Further information is pro- 
vided with the auxiliary hardware. 



19 
20 
21 
128 
129 
130 
131 
132 
133 
134 
135 
136 

137 
138 
139 
140 
141 
142 



LOAD program Too Long: Insufficient memory remains to complete LOAD. 

Device Number Larger than 7 or Equal to 0. 

LOAD File Error: Attempted to LOAD a non-LOAD file. 

BREAK Abort: User hit 1=1:1 JJM kpy during I/O operation. 

IOCB 1 already open. 

Nonexistent Device specified. 

IOCB Write Only. READ command to a write-only device (Printer). 

Invalid Command: The command is invalid for this device. 

Device or File not Open: No OPEN specified for the device. 

Bad IOCB Number: Illegal device number. 

IOCB Read Only Error: WRITE command to a read-only device. 

EOF: End of File read has been reached. (NOTE: This message may occur when 
using cassette files.) 

Truncated Record: Attempt to read a record longer than 256 characters. 

Device Timeout. Device doesn't respond. 

Device NAK: Garbage at serial port or bad disk drive. 

Serial bus input framing error. 

Cursor out of range for particular mode. 

Serial bus data frame overrun. 



TOCB refers to Input/Output Control Block. The device number is the same as the IOCB number. 



r\ 
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ERROR 

CODE NO. ERROR CODE MESSAGE 

143 Serial bus data frame checksum error. 

144 Device done error (invalid "done" byte): Attempt to write on a write-protected 
diskette. 

145 Read after write compare error (disk handler) or bad screen mode handler. 

146 Function not implemented in handler. 

147 Insufficient RAM for operating selected graphics mode. 

160 Drive number error. 

161 Too many OPEN files (no sector buffer available). 

162 Disk full (no free sectors). 

163 Unrecoverable system data I/O error. 

164 File number mismatch: Links on disk are messed up. 

165 File name error. 

166 POINT data length error. 

167 File locked. 

168 Command invalid (special operation code). 

169 Directory full (64 files). 

170 File not found. 

171 POINT invalid. 
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APPENDIX C 



ATASCII 
CHARACTER SET 



jy 






? 



& Jr * 



f 



4r& & 



8 

9 

10 

11 

12 



7 
8 
9 
A 
B 



<? 



□ 



o 



13 






* 



13 



14 



15 



17 



18 



19 



20 



21 



22 



23 



D 



16 10 



11 
12 
13 
14 
15 
16 
17 



24 18 



25 19 



o 



O 

Q 

O 



(J 



26 1A 



27 



28 



29 



30 



31 



32 



36 



IB 



1C 



ID 



IE 



IF 



33 21 



34 22 



35 23 



24 



37 25 



38 26 



II 



20 Space 



% 



& 
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& jy jf /$$> yy f /& J& j> 



yy y* # 



39 27 



40 28 



41 



48 



51 



29 



42 2A 



43 2B 



44 2C 



45 2D 



46 2E 



47 2F 



49 31 



50 32 



33 



52 34 



53 35 



54 36 



/ 



30 



'Vfr # 



55 37 



& V 



56 



38 8 



57 39 



58 3A 



59 3B 



60 3C 



61 3D 



62 3E 



63 3F 



64 40 



65 41 



66 42 



67 43 



68 44 



69 45 



70 46 



A 



B 



D 






71 47 



72 48 



73 49 



74 4A 



75 4B 



76 4C 



77 4D 



78 4E 



79 4F 



80 50 



81 51 



82 52 



83 53 



84 54 



85 55 



86 56 



H 



K 



M 



N 



O 



Q 



R 



U 



V 



n 
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P& jP* 



<r<p $ 



87 



& V 




<& 
& 



& A / j$ & /' m j>y s 



^ s 



88 



57 W 



58 X 



89 59 

90 5A 

91 5B 

92 5C 

93 5D 

94 5E 

95 5F 

96 60 

97 61 

98 62 

99 63 

100 64 

101 65 

102 66 



\ 



o 



<rcT 4? 



4? 




? 



& 
£ 



PUT jFV 



103 67 



104 68 



105 69 



106 6A 



107 6B 



108 6C 



109 6D 



110 6E 



111 6F 



112 70 



113 71 



114 72 



115 73 



116 74 



117 75 



118 76 



m 



n 



u 



'<?$ 



119 77 



120 78 



121 79 



122 7A 



123 7B 



124 7C 



125 7D 



126 7E 



127 7F 



128 80 



129 81 



130 82 



131 83 



132 84 



133 85 



134 86 



w 



□ 

c 
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135 87 



P 



136 



137 



138 



149 



150 



88 
89 
8A 



139 8B 

140 8C 

141 8D 

142 8E 

143 8F 

144 90 

145 91 

146 92 

147 93 

148 94 



95 
96 






151 97 

152 98 

153 99 

154 9 A 

155 9B 

156 9C 

157 9D 

158 9E 

159 9F 

160 A0 

161 Al 

162 A2 

163 A3 

164 A4 



165 
166 



A5 



A6 



& 



(EOL) 

ruji.i.'i 






167 A7 



168 
169 



181 
182 



A8 



A9 



170 A A 



171 AB 



172 AC 



173 AD 



174 AE 



175 AF 



176 BO 



177 Bl 



178 B2 



179 B3 



180 B4 



B5 



B6 
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^ 



^ v 






183 B7 



J- 



184 B8 



185 B9 



186 BA 



187 BB 



188 BC 



189 BD 



190 BE 



191 BF 



192 CO 



193 CI 



194 C2 



195 C3 



196 C4 



197 C5 



198 C6 



ssjP.J- 



199 C7 




200 



201 



202 



C8 
C9 
CA 



203 CB 



204 CC 



205 


CD 


206 


CE 


207 


CF 



208 DO 



209 Dl 



210 D2 



211 D3 



212 D4 



213 D5 



214 D6 



4" / * / 



215 D7 




216 D8 



217 D9 



218 
219 
220 



DA 



DB 



DC 



221 DD 



222 DE 



223 DF 



224 EO 



225 El 



226 E2 



227 E3 



228 E4 



229 E5 



230 E6 
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231 E7 



<? 



232 
233 
234 
235 
236 
237 
238 
239 



E8 



E9 



EA 



EB 



EC 



ED 



EE 



EF 



W /" • 



240 F0 



241 
242 
243 
244 
245 
246 
247 
248 



Fl 



F2 



F3 



F4 



F5 



F6 



F7 



F8 



4^ 4 



249 F9 



250 FA 



251 FB 



252 FC 



253 FD 



254 



255 



FE 



FF 



(Buzzer) 



(Delete 
character) 



(Insert 
character) 



See Appendix H for a user program that performs decimal/hexadecimal conversion. 



Notes: 

1. ATASCII stands for "ATARI ASCII". Letters and numbers have the same values as those in ASCII, but 
some of the special characters are different. 

2. Except as shown, characters from 128-255 are reverse colors of 1 to 127. 

3. Add 32 to upper case code to get lower case code for same letter. 

4. To get ATASCII code, tell computer (direct mode) to PRINT ASC (" ") Fill blank with letter, 

character, or number of code. Must use the quotes! 

5. On pages C-l and C-3, the normal display keycaps are shown as white sym- 
bols on a black background; on pages C-4 and C-6 inverse keycap symbols 
are shown as black on a white background. 
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ATARI 400/800 
MEMORY MAP 



10880 



2A80 



Decimal 


ADDRESS 

Hexadecimal 


CONTENTS 


65535 
57344 


FFFF 
E000 


OPERATING SYSTEM ROM 


57343 
55296 


DFFF 
D800 


FLOATING POINT ROM 


55295 
53248 


D7FF 
D000 


HARDWARE REGISTERS 


53247 
49152 


CFFF 

cooo 


NOT USED 


49151 
40960 


BFFF 
A000 


CARTRIDGE SLOT A 

(may be RAM if no A or B cartridge) 


40959 


9FFF 

8000 


CARTRIDGE SLOT B 

(may be RAM if no B cartridge) 




32768 


RAMTOP (MSB) 










32767 


7FFF 


(7FFF if 32K system) 
DISPLAY DATA (size varies) 




7CIF 


DISPLAY LIST (size varies) 

(7C1F if 32K system, (GRAPHICS 0) 




31755 


n.S MF.MTOP 










FREE RAM 






(size varies) 


BASIC MEMTOP 







BASIC program, buffers, tables, run-time stack 
(2A80 if DOS, may vary) 



OS MEMLO 



_ BASIC LOMEM 



10879 
9856 



2A7F 
2680 



DISK OPERATING SYSTEM (2A7F-700) 

DISK I/O BUFFERS (current DOS) 



9855 
4864 



267F 
1300 



DISK OPERATING SYSTEM RAM (current DOS) 
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ADDRESS 
Decimal Hexadecimal 



CONTENTS 



4863 
1792 



12FF 
700 



FILE MANAGEMENT SYSTEM RAM (current DOS) 



1791 
1536 



6FF 
600 



FREE RAM 



1535 
1406 



5FF 
57E 



FLOATING POINT (used by BASIC) 



1405 
1152 



57D 
480 



BASIC CARTRIDGE 



1151 
1021 



47F 
3FD 



OPERATING SYSTEM RAM (47F-200) 

CASSETTE BUFFER 



1020 
1000 



3FC 
3E8 



RESERVED 



999 
960 



3E7 
3C0 



PRINTER BUFFER 



959 
832 
831 
512 



3BF 
340 
33F 
200 



] IOCB's 

] MISCELLANEOUS OS VARIABLES 



511 
256 



255 
212 



211 
210 



209 
208 



207 
203 



IFF 
100 



FF 



D4 



D3 
D2 



Dl 
DO 



CF 
CB 



HARDWARE STACK 



PAGE ZERO 

FLOATING POINT (used by BASIC) 



BASIC or CARTRIDGE PROGRAM 



FREE BASIC RAM 



FREE BASIC AND ASSEMBLER RAM 



202 
176 

128 



CA 
B0 

80 



FREE ASSEMBLER RAM 



ASSEMBLER ZERO PAGE 



BASIC 
ZERO PAGE 



127 




7F 




OPERATING SYSTEM RAM 



As the addresses for the top of RAM, OS, and BASIC and the ends of OS and BASIC vary according to the 
amount of memory, these addresses are indicated by pointers. The pointer addresses for each are defined 
in Appendix I. 
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APPENDIX E 



DERIVED 
FUNCTIONS 



Derived Functions 

Secant 
Cosecant 
Inverse Sine 
Inverse Cosine 
Inverse Secant 
Inverse Cosecant 
Inverse Cotangent 
Hyperbolic Sine 
Hyperbolic Cosine 
Hyperbolic Tangent 
Hyperbolic Secant 
Hyperbolic Cosecant 
Hyperbolic Cotangent 
Inverse Hyperbolic Sine 
Inverse Hyperbolic Cosine 
Inverse Hyperbolic Tangent 
Inverse Hyperbolic Secant 
Inverse Hyperbolic Cosecant 
Inverse Hyperbolic Cotangent 



Derived Functions in Terms of Atari Functions 

SEC(X) = l/COS(X) 

CSC(X) = 1/SIN(X) 

ARCSIN(X) = ATN(X/SQR(-X*X + 1)) 

ARCCOS(X) = - ATN(X/SQR( - X* X + 1) + CONSTANT 

ARSEC(X) = ATN(SQR(X*X-l)) + (SGN(X-l)*CONSTANT 

ARCCSC(X) = ATN(1/SQR(X*X-1)) + (SGN(X-l)* CONSTANT 

ARCCOT(X) = ATN(X) + CONSTANT 

SINH(X) = (EXP(X)-EXP(-X))/2 

COSH(X) = (EXP(X) + EXP(-X))/2 

TANH(X) = -EXP(-X)/(EXP(X) + EXP(-X))*2 + 1 

SECH(X) = 2/(EXP(X) + EXP(-X)) 

CSCH(X) = 2/(EXP(X)-EXP(-X)) 

COTH(X) = EXP(-X)/(EXP(X)-EXP(-X))*2 + 1 

ARCSINH(X) = LOG(X + SQR(X*X + 1)) 

ARCCOSH(X) + LOG(X + SQR(X*X-1)) 

ARCTANH(X) = LOG((l + X)/(l-X))/2 

ARCSECH(X) = LOG((SQR(-X*X+l) + l)/X) 

ARCCSCH(X) = LOG((SGN(X)*SO:R(X*X + 1) + 1)/X) 

ARCCOTH(X) = LOG((X + l)/(X-l))/2 



Notes: 



1. 



2. 



If in RAD (default) mode, constant = 1.57079633 

If in DEG mode, constant = 90. 

In this chart, the variable X in parentheses represents the value or expression to be evaluated by the 

derived function. Obviously, any variable name is permissible, as long as it represents the number or 

expression to be evaluated. 
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NOTES 
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Notes 



APPENDIX F 



PRINTED VERSIONS 
OF CONTROL CHARACTERS 



The cursor and screen control characters can be placed in a string in a program or used as a Direct mode 
statement by pressing the SB key before entering the character from the keyboard. This causes the 
special symbols which are shown below to be displayed. (Refer to Section 1 - (B| Key.) 



SEE THIS 



PRESS 



PRESS 



PRESS AND 
PRESS HOLD PRESS 




OR 
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NOTES 



Notes 
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GLOSSARY 



Alphanumeric: 
Array: 

ATASCII: 
BASIC: 

Binary: 



Bit: 



Branch: 



Bug: 
Byte: 



Central Processing 
Unit (CPU): 



Code: 

Command: 



The alphabetic letters A-Z, the numbers 0-9, and some symbols. (No 
punctuation marks or graphics symbols). 

A list of numerical values stored in a series of memory locations 
preceded by a DIM statement. May be referred to by use of an array 
variable, and its individual elements are referred to by subscripted 
variable names. 

Stands for Atari American Standard Code for Information Inter- 
change. 

High level programming language. Acronym for Beginner's All- 
purpose Symbolic Intruction Code. BASIC is always written using all 
capital letters. Developed by Mssrs. Kemeny and Kurtz at Dartmouth 
College in 1963. 

A number system using the base two. Thus the only possible digits 
are and 1, which may be used in a computer to represent true and 
false, on and off, etc. 

Short for Binary Digit. A bit can be thought of as representing true or 
false, whether a circuit is on or off, or any other type of two- 
possibility concept. A bit is the smallest unit of data with which a 
computer can work. 

Atari BASIC executes a program in order of line numbers. This ex- 
ecution sequence can be altered by the programmer, and the pro- 
gram can be told to skip over a certain number of lines or return to a 
line earlier in the program. This contrived change in execution se- 
quence is called "branching". 

A mistake or error usually in the program or "software". 

Usually eight bits (enough to represent the decimal number 255 or 
11111111 in binary notation). A byte of data can be used to represent 
an ATASCII character or a number in the range of to 255. 

In microcomputers such as the Atari systems, these are also called 
microprocessors or MPU. At one time, the CPU was that portion of 
any computer that controlled the memory and peripherals. Now the 
CPU or MPU is usually found on a single integrated circuit or "chip" 
(in Atari's case a 6502 microprocessor chip). 

Instructions written in a language understood by a computer. 

An instruction to the computer that is executed immediately. A good 
example is the BASIC command RUN. (See Statement.) 
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Computer: 



Concatenation: 
Control Characters: 
CRT: 

Cursor: 

Data: 
Debug: 

Default: 
Digital: 



Diskette: 



DOS: 

Editing: 
Execute: 

Expression: 

Format: 
Hard Copy: 



Any device that can receive and then follow instructions to 
manipulate information. Both the instructions and the information 
may be varied from moment to moment. The distinction between a 
computer and a programmable calculator lies in the computer's abili- 
ty to manipulate text as well as numbers. Most calculators can only 
handle numbers. 

The process of joining two or more strings together to form one 
longer string. 



Characters produced by holding down the key labeled 
simultaneously pressing another key. 



while 



Abbreviation for "cathrode ray tube" (the tube used in a TV set). In 
practice, this is often used to describe the television receiver used to 
display computer output. Also called a "monitor". 

A square displayed on the TV monitor that shows where the next 
typed character will be displayed. 

Information of any kind. 

The process of locating and correcting mistakes and errors in a pro- 
gram. 

A mode or condition "assumed" by the computer until it is told to do 
something else. For example, it will "default" to screen and keyboard 
unless told to use other I/O devices. 

Information that can be represented by a collection of bits. Virtually 
all modern computers, especially microcomputers, use the digital ap- 
proach. 

A small disk. A record/playback medium like tape, but made in the 
shape of a flat disk that is placed inside a stiff envelope for protection. 
The advantage of the disk over cassette or other tape for memory 
storage is that access to any part of the disk is virtually immediate. 
The Atari 800 Personal Computer System can control up to 4 diskette 
drive peripherals simultaneously. In this manual, disk and diskette 
are used interchangeably. 

Abbreviation for "disk operating system". The software or pro- 
grams which facilitate use of a disk-drive system. DOS is pronounced 
either "dee oh ess" or "doss". 

Making corrections or changes in a program or data. 

To do what a command or program specifies. To RUN a program or 
portion thereof. 

A combination of variables, numbers, and operators (like + , -, etc.) 
that can be evaluated to a single quantity. The quantity may be a 
string or a number. 

To specify the form in which something is to appear. 

Printed output as opposed to temporary TV monitor display. 
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Hardware: 
Increment: 

Initialize: 
Input: 

Interactive: 

Interface: 
IOCB 

I/O: 
K: 

Keyword: 

Language: 

Memory: 

Menu: 

Microcomputer: 
Monitor: 
Null String: 
OS: 

Output: 
Parallel: 

Peripheral: 



The physical apparatus and electronics that make up a computer. 

Increase in value (usually) by adding one. Used a lot for counting (as 
in counting the number of repetitions through a loop). 

Set to an initial or starting value. In Atari BASIC, all non-array 
variables are initialized to zero when the command RUN is given. Ar- 
ray and string elements are not initialized. 

Information transfer to the computer. Output is information transfer 
away from the computer. In this manual, input and output are 
always in relation to the computer. 

A system that responds quickly to the user, usually within a second 
or two. All personal computer systems are interactive. 

The electronics used to allow two devices to communicate. 

Input/Output Control Block. A block of data in RAM that tells the 
Operating System the information it needs to know for an I/O opera- 
tion. 

Short for input/output, I/O devices include the keyboard, TV 
monitor, program recorder, printer, and disk drives. 

Stands for "kilo" meaning "times 1000". Thus 1 KByte is (approx- 
imately) 1000 bytes. (Actually 1024 bytes.) Also, the device type code 
for the Keyboard. 

A word that has meaning as an instruction or command in a com- 
puter language, and thus must not be used as a variable name or at 
the beginning of a variable name. 

A set of conventions specifying how to tell a computer what to do. 

The part of a computer (usually RAM or ROM) that stores data or in- 
formation. 

A list of options from which the user may choose. 

A computer based on a microprocessor chip; in Atari's case, the 6502. 

The television receiver used to display computer output. 

A string consisting of no characters whatever. 

Abbreviation for Operating System. This is actually a collection of 
programs to aid the user in controlling the computer. Pronounced 

"oh ess". 

See I/O. 

Two or more things happening simultaneously. A parallel interface, 
for example, controls a number of distinct electrical signals at the 
same time. Opposite of serial. 

An I/O device. See I/O. 
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Pixel: 

Precedence: 
Program: 
Prompt: 

RAM: 

Random Number 
Generator: 

Reserved Word: 
ROM: 

Save: 

Screen: 
Serial: 

Software: 
Special Character: 

Statement: 

String: 
Subroutine: 

Variable: 
Window: 



Picture Element. One point on the screen display. Size depends on 
graphics mode being used. 

Rules that determine the priority in which operations are conducted, 
especially with regard to the arithmetical/logical operators. 

A sequence of instructions that describes a process. A program must 
be in the language that the particular computer can understand. 

A symbol that appears on the monitor screen that indicates the com- 
puter is ready to accept keyboard input. In Atari BASIC, this takes the 
form of the word "READY". A "?" is also used to prompt a user to 
enter (input) information or take other appropriate action. 

Random Access Memory. The main memory in most computers. 
RAM is used to store both programs and data. 

May be hardware (as is Atari's) or a program that provides a num- 
ber whose value is difficult to predict. Used primarily for decision- 
making in game programs, etc. 

See Keyword. 

Read Only Memory. In this type of solid-state electronic memory, in- 
formation is stored by the manufacturer and it cannot be changed by 
the user. Programs such as the BASIC interpreter and other car- 
tridges used with the Atari systems use ROM. 

To copy a program or data into some location other than RAM (for ex- 
ample, diskette or tape). 

The TV screen. In Atari BASIC, a particular I/O device codes "S:" 

The opposite of parallel. Things happening only one at a time in se- 
quence. Example: A serial interface. 

As opposed to Hardware. Refers to programs and data. 

A character that can be displayed by a computer but is neither a let- 
ter nor a numeral. The Atari graphics symbols are special characters. 
So are punctuation marks, etc. 

An instruction to the computer. See also Command. While all com- 
mands may be considered statements, all statements are certainly not 
commands. A statement contains a line number (deferred mode), a 

keyword, the value to be operated on, and the dEEJI command. 

A sequence of letters, numerals, and other characters. May be stored 
in a string variable. The string variable's name must end with a $. 

A part of a program that can be executed by a special statement 
(GOSUB) in BASIC: This effectively gives a single statement the power 
of a whole program. The subroutine is a very powerful construct. 

A variable may be thought of as a box in which a value may be 
stored. Such values are typically numbers and strings. 

A portion of the TV display devoted to a specific purpose such as for 
graphics or text. 
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APPENDIX H 



USER 
PROGRAMS 



This appendix contains programs and routines that demonstrate the diverse 
capabilities of the Atari Personal Computer System. Included in this appendix is 
a Decimal/Hexadecimal program for those users who write programs that re- 
quire this type of conversion. 

CHECKBOOK Tn i s * s one °f tne "traditional" programs that every beginning computerist 

RATA "MPPT? writes. It allows entry of outstanding checks and uncredited deposits as well as 

£5/VL, J ft.l\IU.bK cleared checks and credited deposits. 

19 DIM A*(30>,HSG$(40M1SGl$(30>,riSG2$(3 
8 h HSG3$< 38 >, NSG4*( 30 ), MSG5K 38 >, MSG6*< 3 

0> 

20 OUTSTAHD=0 

38 GRAPHICS 0=? =? " CHECKBOOK BALAN 

CER"=? 

40 ? "You may make corrections at any ti 

me by enter ins a nesatiue dollar yalue. 
■I 

58 r1SGl$="0LD CHECK — STILL OUTSTANDING 

68 r1SG2*="0LD DEPOSIT — HOT CREDITED 
ii 

78 HSG3$="0LD CHECK — JUST CLEARED 

88 MSG4*="0L0 DEPOSIT — JUST CREDITED 

90 MSG5$="NEW CHECK (OR SERVICE CHARGE';- 

100 MSGS$="HEW DEPOSIT (OR INTEREST) 
ii 

150 TRAP 150=? "Enter besinnins balance 
from your checkbook"; = INPUT YOURBAL 
ISO TRAP" 160 = ? "Enter besinnins balance 
from your bank statement u r- 1 NPUT BANKBAL 
165 TRAP 43088 
170 GOTO 190 

180 CLOSE #1=? "PRINTER IS NOT OPERATION 
AL." 

185 ? "PLEASE CHECK CONNECTORS." 
190 PERM=0 

200 ? "Would you like a permanent record 
on the printer";: INPUT A! 
218 IF LEN(A$>=0 THEN 288 
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228 IF A*a,l)*"N" THEN 488 

238 IF AKMX^Y" THEN 288 

248 TRAP 130 

258 LPRINT = REM TEST PRINTER 

268 PERM=1 

288 LPRINT "Y8UR BEGINNING BALANCE IS $" 

;YOURBAL 

290 LPRINT "BANK STATEMENT BEGINNING BAL 

ANCE IS f H .;BANKBAL^ LPRINT 

408 TRAP 488:? =? "Choose one of the Pol 

lowing" 

418 ? "(1) !, ;MSGil 

415 ? "(2) ";MSG2* 

428 ? "<3> 8 i«SG3$ 

425 ? "(4) ";MSG4* 

430 ? "(5) M1SG5* 

435 ? "<6> ",MSG6I 

440 ? "(7> DONE" 

490 ? 

500 INPUT H-IF H<1 OR N>7 THEN 488 

505 TRAP 48080 

510 ON N GOSUB 1888, 2888, 3888, 4886.. 5888, 



j, 1 1 

528 MSG$="NEW CHECKBOOK BALANCE IS 
" = AMOUNTsYOURBAL : GOSUB 8888 
530 MSG$="NEU BANK STATEMENT BALANCE IS 
" : AMOUNT=BANKBAL : GOSUB 8080 
548 nSGf= ,i OUTSTANDlNG CHECKS-DEPOSITS= 
" ■■ AMOUNT=OUTSTAND ■ GOSUB 8888 
545 IF PERM THEN LPRINT 
550 GOTO 488 

1000 REM OLD CHECK - STILL OUTSTANDING 
1010 ftSG*=rtSGl$: GOSUB 8188 
1020 OUTSTAh€=OUTSTAh€i-fAHOUNT 
1030 RETURN 

2000 REM OLD DEPOSIT — STILL NOT CREDIT 
ED 

2010 MSG$=MSG2*: GOSUB 8188 
2820 OUTSTAhCi=OUTSTANO--AMOUNT 
2038 RETURN 

3000 REM OLD CHECK -- JUST CLEARED 
3810 MSG$=MSG3$- GOSUB 8188 
3020 BANKBAL=BANKBAL -AMOUNT 
3030 RETURN 

4000 REM OLD DEPOSIT — JUST CREDITED 
4010 «SG$=ftSG4$: GOSUB 8188 
4020 BANKBAL=BANKBAL+AMOUNT 
4030 RETURN 

5000 REM NEW CHECK (OR SERUICE CHARGE) - 
- JUST CLEARED 
5010 nSG$=rtSG5* = GOSUB 8188 
5828 YOURBAL=YOURBAL-AMOUNT 
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5838 ? "IS NEW CHECK STILL OUTSTANDING"; 

« INPUT A* 

5846 IF LEHCA$)=0 THEN 5838 

5050 IF AK1,1X>"N" THEN 5968 

5055 BANKBAL=BANKBAL-AMOUNT 

5057 IF PERM THEN LPRINT "CHECK HAS CLEA 
RED." 

5058 RETURN 

5060 IF A$a,lX>"Y" THEN 5838 
5878 OUTSTAND=OUTSTANB+AMQUNT 
5075 IF PERM THEN LPRINT "CHECK IS STILL 
OUTSTANDING." 
5088 RETURN 

6008 REM NEW DEPOSIT (OR INTEREST) — JU 
ST CREDITED 

6018 f1SG$=MSG6$:G0SUB 8180 
6020 YOURBAL=YOURBAL+AMOUNT 
6030 ? "HAS YOUR NEW DEPOSIT BEEN CREDIT 
ED" ; ' INPUT A* 

6040 IF LEN<A$)=8 THEN 6838 
6058 IF A$a,lX>"Y" THEN 6868 

6052 BANKBAL=EANKBAL+Af10UNT 

6053 IF PERM THEN LPRINT "DEPOSIT HAS: BE 
EN CREDITED." 

6055 RETURN 

6068 IF A*U,1X>"N" THEN 6838 

6870 ClUTSTAND=0UTSTAND-AMOUNT 

6075 IF PERM THEN LPRINT "DEPOSIT HAS NO 

T BEEN CREDITED." 

60S0 RETURN 

7000 REM DONE 

7010 ? "BANK'S BALANCE MINUS (QUTSTANBIN 

G CHECKS-DEPOSITS) SHOULD NOW EQUAL 

YOURCHECKBOOK BALANCE . " 

7020 BIF=YOURBAL-( BANKBAL-OUTSTAND ) 

7038 IF 0IFO8 THEN 7848 

7835 ? "IS *";BANKBAL;" THE ENDING BALAN 

CE ON YOUR BANK STATEMENT"; ■• INPUT A$ 

7036 IF LEN<A*)=8 THEN 7835 

7837 IF A*a,l)="Y" THEN ? "CONGRATULATI 
ONS= YOUR CHECKBOOK BALANCES !" = END 

7838 GOTO 7068 

7840 IF DIF>8 THEN ? "YOUR CHECKBOOK TOT 

AL IS *";DIF;" OUER YOUR BANK'S TOTAL. " 

=GOTO 7868 

7858 ? "YOUR CHECKBOOK TOTAL IS *";-OIF; 

" UNDER YOUR: BANK'S TOTAL." 

7060 ? "WOULD YOU LIKE TO MAKE CORRECT 10 

NS?" 

7870 ? "REMEMBER, YOU CAN ENTER A NEGATI 

UE DOLLAR UALUE TO MAKE A CORRECTION. 



H 
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7880 ? "ENTER V OR N H ;= INPUT R* 
7096 IF LEN(A$)=0 THEN END 
7100 IF A*<1,1>="Y" THEN RETURN 
7110 END 

7999 REM ftSG PRINTING ROUTINE 

8000 ? MSG*; 1 ' I*; AMOUNT 

8010 IF PERM=1 THEN LPRINT MSG$; M *";flH0 

UNT 

8020 RETURN 

8100 REM MSG PRINT & INPUT ROUTINE 

8110 TRAP S116 ? "ENTER AMOUNT FOR ";MSG 

$; ■■ INPUT AMOUNT 

8120 TRAP 49080 

8130 IF PERM=1 THEN LPRINT ?1SG*; i! $ !! ;A?10 

UNT 

8140 RETURN 



' 



BUBBLE SORT This program uses the string comparison operator "<= " that orders strings ac- 

cording to the ATASCII values of the various characters. Since Atari BASIC does 
not have arrays of strings, all the strings used in this program are actually 
substrings of one large string. A bubble sort, though relatively slow if there are 
a lot of items to be stored, is easy to write, fairly short, and simpler to under- 
stand than more complex sorts. 

18 DIM BK 1 ) 

28 GRAPHICS '0=? -1 " STRING SO 

RT"=? 

38 TRAP 30:? : ? "Enter maximum strins 1e 

rath" ; : INPUT SLEH = SLEN1=SLEN-1 

35 IF SLEN<1 OR INT<SLENK>SLEN THEN ? " 

PLEASE ENTER A POSITIUE INTEGER > 8. M =G0 

TO 38 

40 TRAP 40 : ? ■? "Enter max i muni number of 
entries. " 

41 ? "(Entries which are shorter than th 

e maximum will be padded with blanks.) 
■I 

42 INPUT ENTRIES 

45 IF ENTRIESC2 OR INK ENTRIES ><>ENTR I ES 
THEN ? "PLEASE ENTER A POSITIUE INTEGER 
> l."=G0T0 43 

47 TRAP 40080 

50 DIM A*<SLEN*EHTRI£S>,TEnP$<SLEN> 

60 ? ; ? "Enter strinss one at a time." 

70 ? "Enter empty sir ins when done (Just 
hitRETURN)." 

75 ? =? "PLEASE STAND BY WHILE THE STRIN 

GS ARE BEING CLEARED. .."; 

80 FOR 1=1 TO SLEN:*ENTRIES = A*<I,I}=" "-N 

EXT I 

85 ? =? 

90 1=1 

100 FOR J=l TO ENTRIES 

110 ? "#" .;.j.;" V INPUT TEMP* 

128 IF LEN< TEMPI )=0 THEN EHTRIES=J-1 : GGT 

190 

130 Al( L I+SLEN1 )=TEMP$ 

140 I=I+SLEN 

150 NEXT J 

190 ? :? :? "PLEASE STAND BY WHILE THE S 

TRINGS ARE BEING SORTEO, . ."; 

200 GOSUB 1008= REM CALL SORT ROUTINE 

202 ? '■? 

205 1=1 

210 FOR K=l TO ENTRIES 

228 ? "#".iK;" ";A$<I,I+SLENi> 

225 I=I+SLEN 

238 NEXT K 

248 TRAP' 388 = ? ■? "WOULD YOU LIKE A PRIN 
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TED COPY";: INPUT B* 

256 IF B$<1,1>="Y" THEN 489 

309 END 

400 I=1=LPRINT = FOR K=l TO ENTRIES 

420 LPRINT "#".;K;" ";A*< M+SLEN1 > 

430 I=I+SLEN:NEXT iOEND 

1000 REM STRING BUBBLE SORT ROUTINE 

1010 FBI INPUT: A$,SL£N, ENTRIES 

1015 REM TEMPS RUST NAME A DIMENSION OF 

SLEN. 

1020 SLEN1=SLEN-1 < MAX=SLEN*< ENTRIES-1 HI 

1040 FOR 1=1 TO MAX STEP SLEN 

1050 DON£=l 

1060 FOR K=l TO MAX-I-SLEN1 STEP SLEN 

1070 KSLEN1=K+SLEN1 < KSLEN=K+SLEN = KSLENSL 

EN1=KSLEN+SLEN1 

1080 IF A$0CKSLEN1X=A$(KSLEN,KSLEN3LEN 

1) THEN GOTO 1118 

1090 DONE=0 

1 100 TEMP*=A$< K.. KSLEN1 ) ■ A*< K, KSLEN1 )=A$( 

KSLEN, KSLENSLEN1 ) = A$< KSLEN, KSLENSLEN1 )=T 

EMP* 

1110 NEXT K 

1120 IF DONE THEN RETURN 

1130 NEXT I 

1140 RETURN 
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TEXT MODES T ^ s program prints the Atari characters in their default colors for text modes 

r"TJ ada r"m? °> 1 > ancl 2 - In enterin g tms program, remember that the clear screen symbol 

CMAKAU 1 fcK «^>, is p rint ed as " } ". 



PRINT 






1 DIM A*< 1 > 

5 ? "}"=REM CLEAR SCREEN 

19 ? "GRAPHICS 8, L AND 2 (TEXT MOOES)" 

28 ? "DEMONSTRATION." 

38 ? "DISPLAYS CHARACTER SETS FOR EACH M 

ODE." 

60 WAIT=1080:REM SUBROUTINE LINE NUMBER 

70 CHBAS=756=R£M CHARACTER BASE ADDRESS 

80 UPPER=224:REM DEFAULT FOR CHBAS 

90 L0i£R=226 = R£M LOWER CASE LETTERS & GR 

APHICS 

95 GOSUB WAIT 

180 FOR L=8 TO 2 

112 REM USE £■■ FOR GRAPHICS 8 

115 IF L=8 THEN OPEN #1,8#8*"E'" : G0T0 11 
8 

116 REM USE $■ FOR GRAPHICS 1 AND 2 

117 OPEN #i,8,8/'S:" 

118 GRAPHICS L 

128 PRINT "GRAPHICS ";L 

138 FOR J=8 TO 7= REM 8 LINES 

148 FOR 1=8 TO 31= REM 32 CHARS--! I NE 

158 K=32SJ+I 

155 REM DON'T DISPLAY "CLEAR SCREEN" OR 

"RETURN" 

168 IF K=ASC("}"> OR K=155 THEN 1S8 

165 IF L=8 THEN PUT #LASC<" ") = REM ESCA 

PE 

178 PUT #LK:REM DISPLAY CHARS 

188 NEXT I 

198 PRINT #1;" " = REM END OF LINE 

288 IF L<>2 OR J<>3 THEN 248 

218 REM SCREEN FULL 

228 GOSUB WAIT 

238 PRINT «;"}■: REM CLEAR SCREEN 

248 NEXT J 

258 GOSUB WAIT 

265 PRINT "LOWER CASE AND GRAPHICS" 

278 IF L<>8 THEN POKE CHBAS, LOWER ■■ GOSUB 

WAIT 

275 CLOSE #1 

288 NEXT L 

388 GRAPHICS 8= END 

1888 REM WAIT FOR "RETURN" 

1818 PRINT "HIT RETURN TO CONTINUE"; 

1828 INPUT A* 

1838 RETURN 
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LIGHT SHOW 



This program demonstrates another aspect of Atari graphics. It uses graphics 
mode 7 for high resolution and the PLOT and DRAWTO statements to draw the 
lines. In line 20, the title will be more effective if it is entered in inverse video 
(use the Atari logo key). 

18 FOR ST=1 TO 8 GRAPHICS 7 

15 POKE 752, 1 

20 ? :? " Atari's Special Lisht Show 

"=SETC0L0R 2,0,8 

30 SETC0L0R 1;2*ST,8= COLOR 2 

40 FOR DR=0 TO 80 STEP ST 

50 PLOT 0,0= DRAWTO 100, OR 

60 NEXT OR: FOR N=l TO SOONEST N-NEXT ST 



70 FOR N=l TO 2030 : NEXT H^GOTO 10 
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UNITED STATES Tnis program involves switching colors to set up the stripes. It uses graphics 
p T -p mode 7 plus 16 so that the display appears as a full-screen. Note the cor- 

Jr-L/iLr respondence of the COLOR statements with the SETCOLOR statements. For fun 

and experimentation purposes, add a SOUND statement and use a READ/DATA 
combination to add "The Star Spangled Banner" after line 470. (Refer to Section 
10.) 

19 REM DRAW THE UNITED STATES FLAG 

29 REN HIGH RESOLUTION 4-COLGR GRAPHICS, 
NO TEXT HINOOH 

30 GRAPHICS 7+ 16 

40 REM SETCOLOR 8 CORRESPONDS TO COLOR 1 

58 SETCOLOR 8, 4, 4= RED* 1 

68 REM SETCOLOR 1 CORRESPONDS TO COLOR 2 

78 SETCOLOR l,BA4-l\miE=2 

80 REM SETCOLOR 2 CORRESPONDS TO COLOR 3 

90 BLUE=3:REM DEFAULTS TO BLUE 

100 REM DRAW 13 RED & WHITE STRIPES 

110 C=RED 

120 FOR I=0 TO 12 

130 COLOR C 

140 REM EACH STRIPE HAS SEIERAL H0RI20NT 

AL LINES 

150 FOR J=8 TO 6 

160 PLOT 8, I*7+J 

170 DRAWTG 159,I*7+J 

130 NEXT J 

190 REM SWITCH COLORS 

200 C=C+MF OWHITE THEN C=RED 

210 NEXT I 

308 REM DRAW BLUE RECTANGLE 

310 COLOR BLUE 

320 FOR 1=8 TO 4S 

338 PLOT 8,1 

348 DRAWTO 79, I 

358 NEXT I 

368 REM DRAW 9 ROWS OF WHITE STARS 

378 COLOR WHITE 

388 K=8=REM START WITH ROW OF 6 STARS 

398 FOR 1=0 TO S 

400 FOR J=0 TO 4: REM 5 STARS IN A ROW 

410 y=K+5+J*14:G0SU8 1880 

420 NEXT J 

430 IF KO0 THEN K=0^GOTO 478 

440 REM ADD 6TH STAR EUERV OTHER LINE 

450 X=5+5S14:G03UB 1888 

468 K=7 

478 NEXT I 

588 REM IF KEY HIT THEN STOP 
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516 IF PEEK( 764 )=255 THEN 518 

515 REM OPEN TEXT WINDOW WITHOUT CLEARIN 

G SCREEN 

528 GRAPHICS 7+32 

525 REM CHANGE COLORS BACK 

538 SETCOLOR 8,4,4:SETC0L0R 1,8,14 

558 STOP 

1808 REM DRAW 1 STAR CENTERED AT X,Y 

1810 PLOT K-hY:ORAWTO K+LY 

1820 PLOT X#Y-1'PL0T X,Y+1 

1038 RETURN 
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SEAGULL OVER Tnis program combines graphics and sounds. The sounds are not "pure" 
r\CV A TV sounds, but simulate the roar of the ocean and the gull's "tweet". The graphics 

ULi.t"\.l\ symbols used to simulate the gull could not be printed on the line printer. Enter 

the following characters in line 20. 

20 BIRD$ = " V — " 



To get these symbols, use 



G, 



R, 



R. 



10 DIM BIRD*: 4) 

20 BIR0$=" 

30 FLAG=i=ROW=10=COL=10 

40 GRAPHICS 1=PDKE 756, 226= POKE 752,1 

50 SETCOLOR M,8:SETC0L0R 1,8,14 

60 PRINT #6.; " the ocean" 

70 R=IHT<RND<Omi> 

80 POSITION 17,17 

90 FOR T=0 TO 10 

100 SOUND 8,T,8,4 

110 FOR h=1 TO 58: NEXT A 

120 IF RNO<8»0.8 THEN FOR 0=18 TO 5 STE 

P -1= SOUND l,8,i0,IHT<RND<S}£10}:NE:* 



XT D= 



SOUND 1,8,0,8 



138 GOSUB 288 

148 NEXT T 

150 FOR T=18 TO 8 STEP -1 

168 SOUND 8,T,8,4 

178 FOR A=l TO 58 = NEXT A 



175 IF RN0<8»8.8 THEN FOR 


0=18 TO 5 STE 


P -1= SOUND 1,0, 18, 8: NEXT 


=S0UN0 1,8,8,8 


188 FOR H=l TO 18 = NEXT H 




185 GOSUB 288 




198 NEXT T 




195 GOTO 78 




200 GOSUB 388 




218 POSITION COL, ROW 




220 PRINT #6; BIRD* FLAG,FLAG+1 > 


238 FLAG=FLAG+2uF FLAG=5 ' 


FHEN FLAG=1 


240 RETURN 




300 IF RND<8»8.5 THEN RET! 


JRH 


310 POSITION COL/ ROW 




320 PRINT #6.; " ■ 




330 A=INT<RND<:3>*3>-i 




348 B=INT(RND(8^3)-1 




358 R0U=RQW+A 




368 IF R0W=S THEN R0W=1 




378 IF R0W=28 THEN R014=19 




380 C0L=C0L+B 




398 IF C0L=8 THEN C0L=1 




488 IF C0L>18 THEN C0L=18 




418 RETURN 
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J 



VIDEO 
GRAFFITTI 



This program requires a Joystick Controller for each player. Each joystick has 
one color associated with it. By maneuvering the joystick, different patterns are 
created on the screen. Note the use of the STICK and STRIG commands. 

1 GRAPHICS 9 

2 ? "UIDEO GRAFFITI" 

5 REM XIY ARRAYS HOLD COORDINATES 

6 REM FOR UP TO 4 PLAYERS' POSITIONS. 

7 REM COLR ARRAY HOLDS COLORS. 
10 DIM A$(1),X(3),Y(3),C0LR(3> 



128 - 

129 

130 - 

131 

132 

133 

134 



"USE JOYSTICKS TO DRAW PICTURES" 
"PRESS BUTTONS TO CHANGE COLORS" 
"INITIAL COLORS:" 

> "JOYSTICK 1 IS RED" 

? "JOYSTICK 2 IS WHITE" 

? "JOYSTICK 3 IS SLUE" 

'( "JOYSTICK 4 IS BLACK (BACKGROUND)" 



135 ? "BLACK LOCATION IS INDICATED BY A 
BRIEFFLASH OF RED." 

136 ? "IN GRAPHICS 8, JOYSTICKS 1 AND 3 
ARE WHITE AND 4 IS BLUE." 

138 PRINT "HOW MANY PLAYERS (1-4)"; 

133 INPUT A$:IF LEN(A$)=8 THEN A$= !! l" 

140 JOYMAX=UAL(A$M 

145 IF J0YMAX<0 OR JGYMAX>=4 THEN 138 

147 PRINT "GRAPHICS 3 (40X24), 5 (88X48) 
ii 

150 PRINT "7 (168X36), OR 3 (320X132)"; 

152 INPUT A$:IF LEN(A*)=8 THEN A$="3" 

153 A=UAL(A$) 

154 IF A=3 THEN XMAX=48 ■ YMAX=24 : GOTO 153 

155 IF A=5 THEN XMAX=88 ■■ YMAX=48 ■ GOTO 153 

156 IF A=7 THEN XMftX=169= YMAX=36 : GOTO 15 
9 

157 IF A=8 THEN KI1AK=329 ^ YMAX=132 = GOTO 1 
59 

158 GOTO 147= REM ft HOT UAL ID 

159 GRAPHICS A+16 

160 FOR 1=0 TO J0YMAX:X(I)=XMAX/2+I:Y(I) 
=YMAX/2+I:NEXT I: REM START NEAR CENTER 
F SCREEN 

161 IF A<>8 THEN 166 

162 FOR 1=0 TO 2:C0LR(I)=1:NEXT I 

163 SETCOLOR 1,3, 14: REM u. BLUE 

165 GOTO 188 

166 FOR 1=0 TO 2:C0LR(I)=I+1:N£XT I 

167 SETCOLOR 8, 4, 6- REM RED 

168 SETCOLOR 1,8,14 REM WHITE 
ISO C0LR(3)=8 

235 FOR J=8 TO 3 
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FOR 1=8 TO JOYMAX=REN CHECK JOYSTICK 
S 

395 REM CHECK TRIGGER 
318 IF STRIGC I ) THEN 321 

311 IF A<>8 THEN 328 

312 COLR^ I >=COLR< I )+l •■ IF COLR( I >=2 THEN 
C0LR<I)=8=REn 2-C0L0R MODE 

313 GOTO 321 

328 COLR< I >=COLR< I >+l - IF COLRC I »=4 THEN 
C0LR(I)=8=REM 4-C0L0R NODE 

321 IF J>8 THEN COLOR COLR(I) : GOTO 325 

322 IF COLR( I )=8 THEN COLOR 1 = GOTO 325 

323 COLOR 8= REM BLINK CURRENT SQUARE ON 
AND OFF 

325 PLOT K(n,Y(I) 

338 JOYIN=STICKCI>:REM READ JOYSTICK 

348 IF J0YIN=15 THEN 536 = REM NO MOVEMENT 

342 COLOR COLRU> : REM HAKE SURE COLOR IS 
ON 

344 PLOT K<i::',YCI> 
358 IF J0YIN>=8 THEN 338 
368 X< I >=XC I )+l -REM riOUE RIGHT 
365 REM IF OUT OF RANGE THEN WRAPAROUND 
378 IF Hi I »=XMAX THEN X< I )=8 
388 GOTO 438 

338 IF J0YIN>=12 THEN 438 
488 X< I >=X< I M ■■ REM NOUE LEFT 
418 IF K(I)<8 THEN XdKflAX-i 
438 IF J0YINO5 AND J0YINO9 AND JOYINO 
13 THEN 478 

448 Y<D=Y<I>+MF YCI»=YMAX THEN Y(D- 
8: REM MOVE DOWN 
468 GOTO 588 

478 IF J0YINO6 AND J0YINO18 AND JOYIN-C 
>14 THEN 588 

488 Y(I)=Y(I)-MF YCIX0 THEN Y< I >=YRAX 
-1 = REI1 NOUE UP 
588 PLOT Xn>,Y(I> 
530 NEXT I 
535 NEXT J 
540 GOTO 235 
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KEYBOARD 
CONTROLLER 



This program alters registers on a chip called a PIA. To set these back to the 
default values in order to do further I/O, hit BBBMB or POKE PACTL,60. If 
this program is to be loaded from disk, use LOAD, not RUN and wait for the 
busy light on the disk drive to go out. Do not execute the program before this 
light goes out, otherwise the disk will continue to spin. 

1 GRAPHICS 8 

5 PRINT = PRINT " KEYBOARD CONTROLLER 

DEMO" 

18 DIM R0W< 3 h IK 13 >.. BUTTON*: 1 ) 

30 GOSUB 6980 

40 FOR CNT=1 TO 4 

60 POSITION 2,CNT*2+5=PRINT "CONTROLLER 

# ";CNT;":"; 

70 NEXT CNT 

80 FOR CNT=1 TO 4=00306 7808= POSITION 19 

,CNT+CNT+5= PRINT BUTTONS =NEXT CHT 

120 GOTO 88 

6009 REM U SET UP FOR CONTROLLERS ** 

6018 P0RTA=54816 * PGRTB=54817 = PACTL=5481S 

=PBCTL=54819 

6028 POKE PACTL,48=P0KE PORTA, 255 POKE P 

ACTL,52:P0KE PORTA, 221 

6025 POKE P8CTL,48:P0KE PORTS, 255 ^ POKE P 

BCTL,52=P0KE P0RTB,221 

6038 RGW< )=238 = R0W< 1 )=22 1 ■■ R0W< 2 )= 1 87 ■ R0 

MC3M19 

6048 I$=" 123456789*0#" 

6058 RETURN 

7808 REM ** RETURN BUTTON* WITH CHARACTE 

R FOR BUTTON WHICH HAS BEEN PRESSED ON C 

0NTR0LLER CNT (1-4). ** 

7001 REM U NOTE' A 1 WILL BE RETURNED I 

F NO CONTROLLER IS CONNECTED. U 

7802 REM U A SPACE WILL BE RETURNED IF 

THE CONTROLLER IS CONNECTED BUT NO KEY H 

AS BEEN PRESSED. U 

7003 P0RT=PORTA=IF CNT>2 THEN P0RT=P0RTB 

7005 P=l 

7008 PA0=CNT+CNT-2 

7810 FOR J=0 TO 3 

7028 POKE P0RT,R0WU) 

7038 FOR 1=1 TO 18: NEXT I 

7850 IF PADDLE(PAD+1»18 THEN P=J+J+J+2^ 

GOTO 7898 

7060 IF PADDLE(PAD»10 THEN P=J+J+J+3=G0 

TO 7090 

7878 IF STRIG<CN7-1>=8 THEN P= J+J+J+4 < GO 

TO 7098 

7080 NEXT J 

7090 BUTTONS I*<P,P> 

7095 RETURN 
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TYPE-A-TUNE T ^i s program assigns musical note values to the keys on the top row of the 

keyboard. Press only one key at a time. 



KEY MUSICAL VALUE 



B 
B'l» (or A#) 

A 

9 Ab (or G#) 

8 G 

7 F#(orGl»') 

6 F 

5 E 

4 B * (or D#) 

3 D 

2 D^ (or Cff) 

1 C 

18 DIM CH0RD<37>,TUNEC12> 
28 GRAPHICS 8 = ? : ? " TYPE-A-TUNE 

PROGRAM" 

25 ? :? "PRESS KEYS l-9,8,<,> TO PRODUCE 
NOTES.".; 

27 ? "RELEASE ONE KEY BEFORE PRESSING TH 
E KEXT . " 

28 ? "OTHERWISE THERE HAY BE A DELAY." 
38 FOR X=l TO 37 ■ READ A = CH0RD< X>=A • NEXT 
v 

40 FOR X=l TO 12= READ A = TUMEC X)=A = NEXT X 

50 OPEN #L4,0,"K=" 
55 0LDCHR=-1 

60 A=PEEK<764> = IF A=255 THEN 68 
63 IF A=0LDCHR THEN 188 
65 0LDCHR=A 

70 FOR X=l TO 12= IF TUNE<X>=A THEN SOUND 
0, CH0RD< X), 18, 8= GOTO 188 
88 NEXT X 

100 I=INT( PEEKC 53775 )/4 ) * IF ( 1/2 )=INT( 1/ 
2) THEN 68 

110 P8KE 764, 255= SOUND 8,8,8,3=0L0CHR=-1 
=G0T0 68 

208 DATA 243,238,217,284,193,132,173,162 
,153, 144, 136, 128, 121, 114, 188, 182,96,91,8 
5,81,76,72,68,64,68 
218 DATA 57,53,58,47,45,42,48,37,35,33,3 

1,29 

228 DATA 31,38,26,24,29,27,51,53,48,58,5 

4,55 



To play "Mary Had A Little Lamb" press the following keys: 

5, 3, 1, 3, 5, 5, 5 3, 3, 3 5, 8, 8 5, 3, 1, 3, 5, 5 5, 5, 3, 3, 5, 3, 1 
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COMPUTER 
BLUES 



This program generates random musical notes to "write" some very interesting 
melodies for the programmed bass. 



1 GRAPHICS 0:? ■'{ " 



COMPUTER BLUE 



C" • •? 

2 PTR=1 

3 THN0T=1 

5 CH0RD=1 

6 PRINT "BASS TEMPO <i=FAST>"; 

7 INPUT TEMPO 

8 GRAPHICS 2+16 = GOSUB 2808 
16 DIM BASE<3,4> 

28 DIM L(M3) 

25 DIM LINE(lb) 

26 DIM JAM(3,7; 
30 FOR X-l TO 3 
40 FOR Y=l TO 4 

50 READ A:BASE<X,Y>=A 

60 NEXT Y 

70 NEXT X 

80 FOR X=l TO 3 = READ A:L0WOO=A 

90 NEXT X 

95 FOR X=l TO 16 •• READ A^LIHE<K)=A:NEXT X 

96 FOR X=l TO 3 

97 FOR Y=l TO 7 

98 READ A:JAM<X,Y>=A=NEXT Y=NEXT X 
100 GOSUB 500 

110 T=T+1 

115 GOSUB 20O 

120 GOTO 100 

200 REM PROCESS HIGH STUFF 

205 IF RNDC8X8.25 THEN RETURN 

210 IF RND<0><0.5 THEN 250 

220 NT=NT+1 

230 IF NT>7 THEN NT=7 

240 GOTO 260 

250 NT=NT-1 

255 IF NT<1 THEN NT=1 

260 SOUND 2,UAM<CHQRD 

280 RETURN 

500 REM PROCESS BASE STUFF 

510 IF BASS=1 THEN 780 

520 BDUR=B0UR+1 

530 IF BOUROTEMPO THEN 535 

531 BASS=1 : 8DUR-8 
535 SOUND 8, LOW? CHORD), 18,4 
540 SOUND 1, BASEC CHORD, THNHl 
550 RETURN 
700 SOUND 8,8,8,8 
718 SOUND 1,8,8,8 



TD,18,NT*2 



!■-', t 



728 BOUR=BOU 



'.:+! 
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738 IF BDUROl THEN 883 

748 BOUR*8 : BASS=0 

758 THHGT=THNCT+1 

768 IF THM0TO5 THEN S88 

765 THN0T=1 

778 PTR=PTR+1 

788 IF PTR=17 THEN PTR=i 

798 CH8RD=LIHE(PTR) 

888 RETURN • 

1888 DATA 162, 144, 136, 144, 121, 188, 182; 18 

8,188,96,91,96 

1818 DATA 243, 182, 162 

1828 DATA 1,1,1,1,2,2,2,2,1,1,1,1,3,2,1, 

1 

1 838 DATA 68 , 58 , 47 , 42 , 48 , 33 , 29 

1848 DATA 68,58,45,42,48,33,29 

1858 DATA 81,68,64,57,53,45,48 

2888 PRINT #6= PRINT #6= PRINT #6 

2885 PRINT #6;" Computer" 

2886 PRINT #6 

2818 PRINT 16; ■ Blues" 

2838 RETURN 
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DECIMAL/ 
HEXADECIMAL 
CONVERSION 
PROGRAM 



This program can be typed in and used to convert hexadecimal numbers to 
decimal numbers and vice versa. 



HEX NUMBER COHU 



18 DIM A$<9>,AD*<1> 

29 GRAPHICS 0=? :? " 
ERS IONS'-? 

30 ? :? "Enter ! D' for DEC to HEM confer 
sion.":? "Enter 'H ! for HEX to DEC corwe 
rsion."= INPUT A* 

40 IF LEN(A$)=0 THEN 33 

50 IF A*="H" THEN 389 

60 IF A*<>"D" THEN 33 

90 TRAP 93 

m 7 =? "ENTER A DECIMAL NUMBER FROM 9 

THROUGH 9399333999 . " 

110 ? "DEC :"; 'INPUT N 

120 IF N<3 OR N>=1E+13 THEN GOTO 180 

138 1=9 

140 TEMP=N:N=INT<N/1S> 

150 TEMP=TEMP-N*1S 

168 IF TEMPC 18 THEN Al( I , I }=STR$< TEMP ) • G 

0T0 188 

170 A$< I , I )=CHRf( TEMP-19+ASCC "A" ) ) 

188 IF N08 THEN 1=1-1 ^GOTO 148 

198 ? "HEX= ";A*<L9>:? 

288 GOTO 118 

308 TRAP 389 

318 ? :? "ENTER A HEX NUMBER FROM 8 THRO 

UGH FFFFFFFF." 

329 ? "HEM:";: INPUT A* 

339 N=8 

348 FOR 1=1 TO LEN(A$) 

345 AD*=A*<M)=IF AD$<"8 n THEN 388 

358 IF A$(LI)(="9 ,i THEN N=H*1 6+UALC AD* > 

:G0TO 378 

355 IF ADI<"A M THEN 389 

357 IF ADfV'F" THEN 389 

369 N=N*16+ASC< AD$ >-ASC< "A" )+19 

378 NEXT I 

388 ? "DEC: ».;H:? 

399 GOTO 328 
408 END 
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APPENDIX I 



MEMORY 
LOCATIONS 



Note: Many of these locations are of primary interest to expert programmers and are included here as a 
convenience. The labels given are used by Atari programmers to make programs more readable. 



COMMENTS AND DESCRIPTION 

Highest location used by BASIC (LSB, MSB) 
TV frame counter (1/60 sec.) (LSB, NSB, MSB) 
Noisy I/O Flag (0 = quiet) 
Attract Mode Flag (128 = Attract mode) 
Left, Right Margin (Defaults 2, 39) 

Current cursor row (graphics window). 

Current cursor column (graphics window). 

Previous cursor row (graphics window). 

Previous cursor column (graphics window). 

Data under cursor (graphics window unless mode 
0). 

Cursor row to which DRAWTO will go. 

Cursor column to which DRAWTO goes. 

Actual top of memory (number of pages). 

BASIC low memory pointer. 

BASIC top of memory pointer. 

Line number at which STOP or TRAP occurred 
(2-byte binary number). 

Error number. 

Print tab width (defaults to 10) 

Low and high bytes of value to be returned to 
BASIC from USR function. 





DECIMAL 


HEXADECIMAL 


LABEL 


LOCATION 


LOCATION 


APPMHI 


14,15 


DE 


RTCLOK 


18,19,20 


12,13,14 


SOUNDR 


G5 

77 


41 


LMARGIN, 


82,83 


52,53 


RMARGIN 






ROWCRS 


84 


54 


COLCRS 


85,86 


55,56 


OLDROW 


90 


5A 


OLDCOL 


91,92 


5B 




93 


5C 


NEWROW 


96 


60 


NEWCOL 


97,98 


61,62 


RAMTOP 


106 


6A 


LOMEM 


128,129 


80,81 


MEMTOP 


144,145 


90,91 


STOPLN 


186,187 


BA,BB 


ERRSAV 


195 


C3 


PTABW 


201 


C9 


FRO 


212,213 


D4,D5 
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DECIMAL 


HEXADECIMAL 


LABEL 


LOCATION 


LOCATION 


RADFLG 


251 


FB 


LPENH 


564 


234 


LPENV 


5G5 


235 


TXTROW 


656 


290 


TXTCOL 


657,658 


291,292 


COLORO 


708 


2C4 


COLOR1 


709 


2C5 


COLOR2 


710 


2C6 


COLOR3 


711 


2C7 


COLOR4 


712 


2C8 


MEMTOP 


741,742 


2E5,2E6 


MEMLO 


743,744 


2E7,2E8 


CRSINH 


752 


2F0 


CHACT 


755 


2F3 



CHBAS 



756 



2F4 



ATACHR 


763 


2FB 


CH 


764 


2FC 


FILDAT 


765 


2FD 


DSPFLG 


766 


2FE 


SSFLAG 


767 


2FF 


HATABS 


794 


31A 


IOCB 


832 


340 




1664-1791 


680-6FE 


CONSOL 


53279 


D01F 


* Future product. 
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COMMENTS AND DESCRIPTIONS 

RAD/DEG flag (0 = radians, 6 = degrees). 

Light Pen* Horizontal value. 

Light Pen* Vertical value. 

Cursor row (text window) 

Cursor column (text window) 

Color Register 

Color Register 1 

Color Register 2 

Color Register 3 

Color Register 4 

OS top of available user memory pointer (LSB, 
MSB) 

OS low memory pointer 

Cursor inhibit (0 = cursor on, 1 = cursor off) 

Character mode register (4 = vertical reflect; 2 = 
normal; 1= blank) 

Character base register (defaults to 224) (224 = up- 
per case, 226 = lower case characters) 

Last ATASCII character. 

Last keyboard key pressed; internal code; (255 
clears character). 

Fill data for graphics Fill (XIO). 

Display Flag (1 = display control character). 

Start/Stop flag for paging (0 = normal listing) Set by 

Hi. 



Handler address table (3 bytes/handler) 

I/O control blocks (16 bytes/IOCB) 

Spare RAM 

Console switches (bit 2 = Option; bit 1 = Select; bit 
- Start. POKE 53279, before reading. = 
switch pressed.) 



\ 



DECIMAL 


HEXADECIMAL 


LABEL LOCATION 


LOCATION 


PORTA 54016 


D300 


PORTB 54017 


D301 



PACTL 

PBCTL 
SKCTL 



54018 

54019 
53775 



D302 

D303 
D20F 



COMMENTS AND DESCRIPTIONS 

PIA Port A Controller Jack I/O ports. 
PIA Port B Initialized to hex 3C. 

Port A Control Register (on Program Recorder 52 
= ON, 60 = OFF). 

Port B control register. 

Serial Port control register. Bit 2 = (last key still 
pressed). 
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V 



INDEX 



A Abbreviations, 4-5 

Commands in headings, 4 
ABS, 33 
adata, 5 
ADR, 35,63 
aexp, 4 
aop, 4 

Array, 3-4, 41 
ASC, 37 

ATASCII, 5, 40, C-l through C-6 
ATN, 34 

Audio track of cassette, 23 
avar, 4 

B BASIC, 1 

Blanks (see Spaces) 
Booting DOS, 25 
Braces, 4 
Brackets, 4 
Branching, 

Conditional Statements, 19 

Unconditional Statements, 17 
Brightness (see Luminance) 
Bubble Sort Program, H-5 
Buzzer, 14 

Deferred Mode, F-l 

Direct Mode, 14 
BYE, 9 

C C-Scale Program, 58 

Central Input/Output Subsystem, 23 
Character 

Assigning Color to, 54 

ATASCII, C-l through C-6 

Display at specified locations, 46, 47 

Set, internal, 55 

Sizes in Text modes, 46 
Chaining Programs, 30 

Checkbook Balancer Program, H-l through H-4 
CHR$, 58 

CIO (see Central Input/Output Subsystem) 6 
CLEAR key, 6 
Clear Screen, 

Deferred mode, 5, 14, 46 

Direct mode, 6, 46 
CLOAD, 24 
CLOG, 33 
CLOSE, 27 
CLR, 43 
Codes, 

Device, 23-24 
Colons, 3, 61 
COLOR, 48 



D 



Color 

Assigning, 54 

Changing, 50 

Default, 46, 51 

Registers, 50 
COM (see DIM) 

Computer Blues Program, H-16 
emdno, 30 
Comma, 26, 27 
Command Strings, 1 
Commands 

BYE, 9 

CONT, 9 

END, 9 

LET, 10 

LIST, 10 

NEW, 10 

REM, 10 

RUN, 11 

STOP, 11 
Conservation, 

Memory, 61 
Constant, 2 
CONT, 9 
Controllers, 

Game, 59 
COS, 34 
CSAVE, 24 
Cursor, 9 

Graphics, 49 

Inhibit, 46 

Decimal/Hexadecimal Conversion Program, H-18 
Default 

colors, 46 

disk drive, 24, 29 

margins in Mode 0, 46 

tab settings, 6 
Deferred mode, 5 
DEG, 35 
Devices, 23-24 
Delete line, 13 
DIM, 41 
Direct mode, 5 
Disk Drive 

Default number, 24, 29 

Requirements (see ATARI DOS Manual) 
Disk file 

Modification of BASIC program, 31 
Display, split-screen override, 45, 47 
Distortion, 57 
DOS, 25 
DRAWTO, 48 



Index 117 



Editing, screen, 13 
Editor, Screen, 24 
END, 9 

before subroutine, 7 
End of file, 14 

Error messages, B-l through B-3 
Escape key, 5 

with Control Graphics Symbols, F-l 
EXP, 33 
exp, 5 

Exponentiation symbol, 6 
Expression, 1 

Arithmetic (see aexp) 

Logical (see lexp) 

String (see sexp) 

filename, breakdown, 27 
filespec, 5 

Usage, 26, 27 
Fill (XIO), 54 
FOR/NEXT, 15 

building arrays and matrices, 42 
with STEP, 15 
without STEP, 15 
FRE, 35 
Function, 1 
Arithmetic 
ABS, 33 
CLOG, 33 
EXP, 33 
INT, 33 
LOG, 34 
RND, 34 
SGN, 34 
SQR, 34 
Built-in, 7 
Derived, E-l 
Library, 33 
Special Purpose, 35 
ADR, 35 
FRE, 35 
PEEK, 35 
POKE, 35 
USR, 36 
Trigonometric, 34 
ATN, 34 
COS, 34 
DEG, 35 
RAD, 35 
SIN, 35 

Game controllers 

Keyboard, 59 

Joystick, 59 

Paddle, 59 

Video Graffitti program, H-12 through H-13 
Game controller commands 

PADDLE, 59 

PTRIG, 59 

STICK, 59 

STRIG, 60 
GET, 28, 49 
GOSUB/RETURN, 16, 21 



GOTO, 17 

with conditional branching, 17 
GRAPHICS, 45 
Graphics 
Modes, 46-47 
Statements, 48 

COLOR, 48 

DRAWTO, 49 

GET, 45 

GRAPHICS, 48 

LOCATE, 48 

PLOT, 49 

POSITION, 49 

PUT, 49 

SETCOLOR, 50 

XIO (Fill), 54 
Graphics Control Characters, 56 

H Harmony, 57 
Hexadecimal 
/Decimal Conversion Program, H-18 
Hexcode Loader program, 64 

I INPUT, 25 

Input/Output Commands, 23 

CLOAD, 24 

CLOSE, 27 

CSAVE, 24 

DATA, 28 

DOS, 25 

ENTER, 25 

GET, 28 

INPUT, 25 

LOAD, 26 

LPRINT, 26 

NOTE, 26 

OPEN, 26 

POINT, 28 

PRINT, 3, 5, 14, 26 

PUT, 28 

READ, 28 

SAVE, 29 

STATUS, 29 

XIO, 29 
Input/Output Devices 

Disk Drives (D:), 24 

Keyboard (K:), 23 

Line Printer (L:), 23 

Program Recorder (C:), 23 

RS-232 Interface (R:), 24 

Screen Editor (E:), 24 

TV Monitor (SO, 24 
INT, 33 

Internal pointer for DATA, 21 
Input/Output Control Block, 23 
Inverse Key, 5 

Invisible graphics cursor, 48-49 
IOCB (see Input/Output Control Block) 



J Joystick Controller, 59 

K Keyboard (K:), 23 

Keyboard Controllers, 59 



t*. 
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RS-232(R:), 24 
RTS, 63 
RUN, 11 

S SAVE, 29 

Save programs on cassette tape, 24 

Screen Display (see TV Monitor) 

Screen Editor (E:), 24 

Seagull Over Ocean Program, H-ll 

Semicolon, 28 

SETCOLOR, 50-53 

sexp, 5 

SGN, 34 

SIN, 35 

SOUND, 57 

terminating, 9, 57 
Spaces, 61 
SOR, 34 
Stack, 16 

GOSUB, 16 

Hardware, 36 

loop addresses, 16, 21 

POP, 20 
Statement, 

Program, 15 

FOR, 15 

GOSUB, 16, 21 

GOTO, 17 

IF, 18 

ON/GOSUB, 20 

ON/GOTO, 20 

POP, 20 

RESTORE, 21 

RETURN, 16 

STEP, 15 

THEN, 18 

TO, 15 

TRAP, 22 
STEP, 15 
STOP, 11 
String 

Comparison, 40 

Concatenation, 39 

Dimensioning, 37 

Functions 
ASC, 37 
CHR$, 37 
LEN, 38 
STR$, 38 
VAL, 38 

Manipulation, 39 

Sort, 40 

Splitting, 39 

Variable, 4 
STR$, 38 
Subroutine 

Definition, 16 

GOSUB, 16 

Usage, 16 
svar, 4 

T Terminology, 1 
Text modes, 46 



Text Modes Characters Program, H-7 

Tokenized version, 3, 24 

Tone, clipped, 57 

TRAP, 22 

Type-A-Tune Program, H-15 

U Untokenized version, 3 

V var, 4 
Variable, 2 

avoiding name limit, 2 
Video Graffitti Program, H-12 
Volume control, 57 
Voice, 57 

W Window 

Graphics, 47 
Text, 47 
Wraparound 8 

X X-coordinate 17 
XIO, 29 
XIO (Fill). 54 

Y Y-coordinate, l. 

Z Zero 

as Dummy Variable, 30, 34 
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Keyboard Controller Program, H-14 
Keys 
Special Function 
ATARI, 5 
BACK SPACE, 6 
BREAK, G 
CAPS/LOWR, 5 
CLEAR, G 
DELETE, 6 
ESCAPE, 5 
INSERT, 6 
RETURN, 6 
SYSTEM RESET, 6 
TAB, G 
Editing 
CTRL (Control) Key, 13 
SHIFT key, 13 
Cursor Control, 14 
Down arrow, 14 
Left arrow, 14 
Right arrow, 14 
Up arrow, 14 
Keywords 
BASIC, A-l through A-5 

LEN, 38 
LET, 2, 3, 10 
Letters 

Capital (upper case), 3 

Lower case, 3, 47 
lexp, 4 

Light Show Program, H-8 
Line 

Format, 3 

Logical, 2 

Numbers, 3 

Physical, 2 
lineno, 5 
LIST, 10 
LOAD, 26 

Load program from cassette tape, 24 
LOCATE, 48 
LOG, 34 
Loops 

Endless, 17 

Nested, 15 
lop, 4 
LPRINT, 26 

before CSAVE, 24 
Luminance, 50 

Mandatory » symbol, 26, 27 
Margins 

Changing, 36, 46 

Default in mode 0, 46 
Matrix, 41-42 

Variable, 4 
Memory Map, D-l through D-2 
Modes, graphics, 46, 47 
Modes, operating 

Deferred, 5 

Direct, 5 

Execute, 5 

Memo Pad, 5, 25 



Modes, text, 46 

Override split-screen, 47 
Multiple commands {see 

Command Strings) 
mvar, 4 

N NEW, 10 
Notations 
floating point, 39 
in manual, 3 



o 



Q 



R 



ON/GOSUB, 20 
ON/GOTO, 20 
OPEN, 26-28 
Operators, 2 

Arithmetic, 4, 6 

Binary, 6, 7 

Logical, 4, 6 

Relational, 7 

Unary, 6 
Output devices, 23 
Oversized programs {see Chaining Programs) 

Paddle Controller, 59 
Parentheses, 

Usage, 7, 63 
PEEK, 35 

Peripheral devices {see Input/Output Devices) 
Pitch 

Definition, 57 

Values, 58 
Pixel, 48 

Size in modes, 47 
PL A, 63 
PLOT, 49 
POINT, 28 
POKE, 35 
POP, 20-21 
POSITION, 49 
Precedence, operator, 7 
PRINT, 3, 5, 14, 26 
Printer listing, 10 
Program continuation, 11 
Programs, 

Machine language, 67 

User, Appendix H 

with Hexcode Loader, 65, 66 
PUT, 49 

Question mark as prompt, 25 
Quotation marks, 2 

RAD, 35 

RAM (Random Access Memory), 23 
Random Access to disk file, 28 
READ, 28 

Direct mode, 28 
REM, 10 
RESTORE, 21 
RETURN Key, 6 
Return, Abnormal {see POP) 
Rollover, 

Keyboard, 8 
RND, 34 
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TABLE OF MODES 
AND SCREEN FORMATS 



Gr. 
Mode 


Mode 
Type 


Horiz. 
(Columns) 


Vert. (Rows) 
Split 
Screen 


Vert. (Rows) 

Full 

Screen 


#Of 
Colors 


RAM 

Required 

(Bytes) 



1 
2 
3 
4 
5 
6 
7 
8 


TEXT 
TEXT 
TEXT 
GRAPHICS 
GRAPHICS 
GRAPHICS 
GRAPHICS 
GRAPHICS 
GRAPHICS 


40 
20 

40 
80 
80 
160 
160 
320 


20 
10 
20 
40 
40 
80 
80 
160 


24 
24 
12 
24 
48 
48 
96 
96 
192 


2 
5 
5 
4 
2 
4 
2 
4 
1/2 


993 

513 

261 

273 

537 

1017 

2025 

3945 

7900 






" 



MODE, SET COLOR, COLOR TABLE 



Default 
Colors 


Mode or 
Condition 


SETCOLOR 

(aexpl) 

Color 

Register No. 


Color 
(aexp) 


DESCRIPTION AND COMMENTS 


LIGHT BLUE 
DARK BLUE 

BLACK 


MODE and 
ALL TEXT 
WINDOWS 



1 

2 
3 
4 


COLOR data 

actually 

determines 

character to 

be plotted 


Character luminance (same color as background) 
Background 

Border 


ORANGE 

LIGHT GREEN 

DARK BLUE 

RED 

BLACK 


MODES 1 

and 

2 

(Text Modes) 



1 
2 
3 
4 


COLOR data 

actually determines 

character to be 

plotted 


Character 
Character 
Character 
Character 
Background. Border 


ORANGE 

LIGHT GREEN 

DARK BLUE 

BLACK 


MODES 3, 5, 

and 7 

(Four-color 

Modes) 



1 
2 
3 

4 


1 
2 
3 




Graphics point 
Graphics point 
Graphics point 

Graphics point (background default), Border 


ORANGE 

BLACK 


MODES 4 

and 6 

(Two-color 

Modes) 

4 



1 
2 
3 



1 


Graphics point 

Graphics point (background default), Border 


LIGHT GREEN 
DARK BLUE 

BLACK 


MODE 8 

(1 Color 

2 Luminances) 




1 

2 
3 
4 


1 



Graphics point luminance (same color as background) 
Graphics point (background default) 

Border 



